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CHAPTER 1 


IN TRODUCTION 


Subroutines to handle I/O transfers between a PDP-11 and each of its 
peripheral devices are developed as required for use within the Disk 
Operating System (DOS) . These subroutines are made available within 
an I/O Utilities Package for the benefit of PDP-11 users who have con- 
figurations unable to support DOS or who wish to run programs outside 
DOS control. 

All the subroutines associated with one peripheral device togeth- 
er form an entity which is known as a Driver. The purpose of this docu- 
ment is to provide a general description of a driver and to show how 
it may be used in a stand-alone environment. The unique properties of 
each driver are discussed in separate documents issued as supplements 
to this one. The I/O Utilities Package for any system is determined by 
the peripherals of that system. Thus the full documentation for a 
particular package consists of this document and the applicable supple- 
ments . 

Within this document, Chapter 2 consists of an outline of the es- 
tablished driver structure and its interface to the program using it. 
Chapter 3 then illustrates how a stand-alone program can match this 
interface in order to make immediate use of each driver as supplied 
within the package. For the benefit of those users who require a more 
detailed description of the driver format, perhaps so that they can 
write their own drivers for other unsupported devices in a similar 
fashion, the standard specification for DOS driver has been attached 
as Appendix A. It is assumed that the reader is familiar with the 
basic hardware concepts of the PDP-11 as described in the PDP-11 Hand- 
book and with the Paper Tape Software as described in the Programming 
Handbook (DEC-ll-GGPB-D) . 
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CHAPTER 2 


DRIVER FORMAT 


2 . 1 Structure 

The basic principle of all drivers under the DOS Monitor is that they 
must present a common interface to the routines using them in order to 
provide for device-independent operation. The subroutines are 
structured to meet this end. Moreover, the driver may be loaded any- 
where in memory under Monitor control. Its code must always, there- 
fore, be position-independent. 

The detailed description of a driver is found in Appendix A. This 
chapter is concerned with driver interfaces. 

2.1.1 Driver Interface Table 

The first section of each driver consists of a table which contains, 
in a standard format, information on the nature and capabilities of the 
device it represents and entry pointers to each of its subroutines. 

The calling program may then use this table as required, regardless of 
the device being called. 

2.1.2 Setup Routines 

Each driver is expected to handle its device under the PDP-11 interrupt 
system. When called by a program, therefore, a driver subroutine mere- 
ly initiates the action required by setting the device hardware regis- 
ters appropriately. It then returns to the calling program by a stan- 
dard subroutine exit. 

The main setup routine prepares for a data transfer to or from the 
device, using parameters supplied by the calling program. Normally, 
blocks of data will be moved at each transfer. The driver will only 
return control to the program when the whole block has been actioned or 
when it is unable to continue because there is no more data available. 

The driver may also contain subroutines by which the calling 
program may request start-up or shut-down action, such as leader or 
trailer code at a paper-tape punch, or some special function provided 
by the device hardware (or a software simulation of that for some 
similar device), e.g., "rewind" of a magnetic tape (or DECtape) . 

2.1.3 Interrupt Servicing 

The nature of the driver routine to service device interrupts is 
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particularly dependent upon the extent of the hardware provisions of 
the device for controlling transfers. In general, the driver deter- 
mines the cause of the interrupt and checks whether the last action 
was performed correctly or was prevented by some error condition. If 
more device action is needed to satisfy the program, the driver again 
initiates that action and takes a normal interrupt exit. If the 
program request has been fully met, control is returned to the program 
at an address supplied at the time of the call. 

2.1.4 Error Handling 

Device errors may be handled in two ways- There are some errors for 
which recovery can be programmed; the driver will, if appropriate, 
attempt this itself (as in the case of parity or timing failure on a 
bulk-storage device) or will recall the program with the error con- 
dition flagged (as at the end of a physical paper tape) . Other errors 
will normally require action externally, perhaps by an operator. For 
the latter, the driver calls a common error handler based on location 
34 (IOT call) with supporting information on the processor stack. 

2 . 2 Interface to the Driver 

2.2.1 Control Interface 

The principal link between a calling program and any driver subroutine 
is the first word of the driver table. In order to provide the con- 
trol parameters for a device operation, the calling program prepares 
a list in a standardized form and places a pointer to the list in the 
driver link. The called driver then uses the pointer to access the 
parameters. If the driver need then return status information, it may 
again place this in the list area via the link-word. 

The first word of the driver also may act as an indicator in that 
while it remains 0, the driver is not already busy upon some task, 
whereas when the word contains a list-pointer, the driver is assumed 
to be busy. Since most drivers can only support one job at a time, the 
link-word state can be significant. 

2.2.2 Interrupt Interface 

Although the driver will always expect to use the interrupt system, it 
does not itself ensure that its interrupt vector in the memory area 
below 400 has been set up correctly; the Monitor under DOS takes care 
of this. However, the Driver Table contains the necessary information 
to allow the vector to be set correctly. 
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CHAPTER 3 


STAND-ALONE USAGE 


Because each driver is designed for operation within the device- 
independent framework of DOS Monitor, it may be similarly used in 
other applications. Possible methods will be discussed later. How- 
ever, since the easiest way to use the driver is to assemble it with 
the program requiring it, this will be described first. 

3 . 1 Driver Assembled with Program 

3.1.1 Setting Interrupt Vector 

As noted in Section 2.2.2, the calling program must first correctly 
set the device transfer vector within memory locations 0-377. The 
address of the driver's interrupt entry point can be identified on 
the source listing by the symbolic name which appears as the content 
of the Driver Table Byte, DRIVER+5. The priority level at which the 
driver expects to process the interrupt is at byte DRIVER+6 . For a 
program which can use position-dependent code, the setup sequence 
may be : 


MOV #DVRINT, VECTOR ; SET INT. ADDRESS 

MOVB DRIVER+6, VECTOR+2 ; SET PRIORITY 

CLRB VECTOR+3 ; CLEAR UPPER STATUS BYTE 


(where the Driver Table shows at DRIVER +5: .BYTE DVRINT-DRIVER) . 


If the program must be position-independent, it may take advan- 
tage of the fact that the Interrupt Entry address is actually stored 
as an offset from the start of the driver, as illustrated above. In 
this case, a sample sequence might be: 


MOV 

PC, Ri 

; GET' DRIVER START 

ADD 

# DRIVER- . , Rl 


MOV 

fVECTOR, R2 

; . . . & VECTOR ADDRESSED 

CLR 

@R2 

; SET INT. ADDRESS 

MOVB 

5 (Rl) , @R2 

; . . .AS START ADDRESS+OFFSET 

ADD 

Rl, (R2)+ 


CLR 

@R2 

; SET PRIORITY 

MOVB 

6 (Rl) , @R2 



3.1.2 Parameter Table for Driver Call 

For any call to the driver, the program must provide the list of 
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control arguments mentioned in Section 2.2.1. This list must adhere 
in general to the following format: 1 


[SPECIAL FUNCTION CODE] 2 
[BLOCK NO. ] 3 

STARTING MEMORY ADDRESS FOR TRANSFER 

NO. OF WORDS to be transferred (2's complement) 

STATUS CONTROL showing in Bits: 

0-2: Function (octally 2=WRITE , 4=READ) 4 

8-10: Unit (if Device can consist of several, e.g., DECtape) 

11: Direction for DECtape travel (0 = Forward) 

ADDRESS for RETURN ON COMPLETION 
[RESERVED FOR DRIVER USE] 5 

The list itself may be assembled into the required format if its 
content will not vary. The driver may return information in the area 
as described in a later paragraph; however, this will not corrupt the 
program data and it is removed by the driver before it begins its 
next operation. 

On the other hand, most programs will probably wish to use the 
same area for the lists for several tasks or even between different 
drivers. In this case, the program must contain the necessary routine 
to set up the list for each task before making the driver call, per- 
haps as illustrated in the next paragraph. It must be noted, however, 
that the driver may wish to refer to the list again when it is re- 
called by an interrupt or to return information to the calling program. 
Therefore, the list must not be changed until any driver has completed 
a function requested; for concurrent operations, different list areas 
must be provided. 

3.1.3 Calling the Driver 

To enable the driver to access the parameter list, the program must 
set the first word of the driver to an address six bytes less than that 


x In some cases, it may be further extended as discussed in later para- 
graphs . 

2 Required only if Driver is being called for Special Function. 

3 Required only if the Device is bulk storage (e.g.. Disk or DECtape). 

4 Most devices transfer words regardless of their content, i.e. ASCII 
or Binary. Some devices, e.g., Card Reader, may be handled different- 
ly for the two modes; for these. Bit 0 must also be set to indicate 
ASCII-0, Binary=l. (In these cases, the driver always produces or 
accepts ASCII even though the device itself uses some other code.) 

5 This word may be omitted if the device is bulk storage (see below) . 


3-2 



of the word containing MEMORY START ADDRESS. It may then call the 
driver subroutine required directly by a normal JSR PC,xxxx call. 


As an example, the following position-independent code might 
appear in a program which wishes to read Blocks #100-103 backward 
from DECtape Unit into a buffer starting at address BUFFER: 



MOV 

PC , R0 


ADD 

#TABLE+12- . ,R0 


MOV 

PC , @R0 


ADD 

# RETURN- . , @R0 


MOV 

#5404, -(R0) 


MOV 

#-1024. ,-(R0) 


MOV 

PC , - (R0) 


ADD 

#BUFFER- . ,@R0 


MOV 

#103, -R0) 


CMP 

-(R0) ,-(R0) 


MOV 

R0,DT 


JSR 

PC , DT . TFR 

WAIT 

: • 


RETURN 

v 


TABLE 

: .WORE 

l 0 


.WORD 0 
.WORD 0 
.WORD 0 
.WORD 0 


; GET TABLE ADDRESS 

; GET & STORE... 

; . . . RETURN ADDRESS 
; SET READ REV. UNIT 3 
; 4 BLOCKS REQUIRED 
; GET & STORE 
; . . .BUFFER ADDRESS 
; START BLOCK 

; SUBTRACT 4 FROM POINTER 
; SET DRIVER LINK 
; GOTO TRANSFER ROUTINE 
; RETURNS HERE WHEN 
; . . .TRANSFER UNDERWAY 
; RETURNS HERE WHEN 
; . . . TRANSFER COMPLETE 
; LIST AREA SET 
; . . .BY ABOVE SEQUENCE 


3.1.4 User Registers 

During its setup operations for the function requested, the driver 
assumes that Processor Registers 0-5 are freely available for its 
purpose. If their contents are of value, the program must save them 
before the driver is called. 


While servicing intermediate interrupts, the driver may need to 
save or restore these registers. It expects to have available two 
subroutines for the purpose (provided by the Monitor under DOS) 

It accesses them via addresses in memory locations 44 (SAVE) and 46 
(RESTORE) using the sequence: 

MOV @#44, -(SP) ; OR 'MOV @#46, -(SP) 

JSR R5 , @ (SP) + 

The program must, therefore, contain these subroutines. They 
might, for example, be as follows: 
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SAVE: 


RESTOR: 


MOV 

R4 , - (SP) 

; SAVE R0-4 

MOV 

R3, - (SP) 

; . . . R5 SAVED BY CALL 

MOV 

R2 ,- (SP) 


MOV 

Rl,- (SP) 


MOV 

Rj2f , - (SP) 


MOV 

R5 , PC 

; EXIT TO CALLER 

INC 

(SP)' + 

; FORGET CALL R5 

MOV 

(SP)+,R0 

; RESTORE R0-4 

MOV 

(SP) + , Rl 


MOV 

(SP) +,R2 


MOV 

(SP)+,R3 


MOV 

(SP ) + , R4 


RTS 

R5 

;R5 RESET ON EXIT 


It must also ensure that their start addresses are set into the cor- 
rect locations. 


At its final interrupt, the driver always saves the contents of 
Registers 0-5 before returning control to the calling program comple- 
tion return. 

3.1.5 Returns from Driver 

As shown in the example in section 3.1.3, the driver returns control 
to the calling program immediately after the JSR as soon as it has set 
the device in motion. The program may then wait or carry out some 
alternative operations until the driver signals completion by return- 
ing at the address supplied, i.e., RETURN above. Prior to this, the 
program should not attempt to access the data being read in, or to 
refill a buffer being written out. 

The program routine beginning at address RETURN will vary accord- 
ing to the device in use. In general, the driver has given control to 
the routine for one of two reasons, namely, the function has been 
satisfactorily performed, or it cannot be carried out due to some hard- 
ware failure with which the driver is unable to cope, though the 
program may. If the latter, the driver uses the STATUS word in the 
program list to show the cause: 

Bit 15 = 1 indicates that a device parity or timing failure 
has occurred and the driver has not been able to 
overcome this, perhaps after several attempts. 

Bit 14 = 1 shows that the end of the data available has been 
reached. 

The driver places in R0 the content of its first word as a 
pointer to the list concerned. 
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In addition, the driver may have transferred only some of the data 

— r equ i red . In this — case , — it will — show , — in the RESE RVED word of the 

program list, a negative count of the words not transferred in addition 
to setting Bit 14 of the STATUS. As mentioned in the note in Section 
3.1.2, this applies only to non-bulk storage devices. The drivers for 
DECtape or Disks 1 always endeavor to complete the full transfer, even 
beyond a parity failure, or they take more drastic action (see "Section 
3.1.6) . 

It is thus the responsibility of the program RETURN routine to 
check the information supplied by the driver in order to verify that 
the transfer was satisfactory and to handle the error situations 
accordingly. 

In addition, the routine must contain a sequence to take care 
of the Processor Stack, Registers, etc. As noted earlier, the driver 
takes the completion return address after an interrupt and has saved 
Registers 0-5 on the stack above the Interrupt Return Address and 
Status. The program routine should, therefore, contain some sequence 
to restore the processor to its state prior to such interrupt, e.g., 
using the same Restore subroutine illustrated earlier: 

MOV @#46 , - (SP) ; CALL REGISTER RESTORE 

JSR R5,@(SP)+ 

RTI ; RETURN TO INTERRUPTED PROG. 

3.1.6 Irrecoverable Errors 

All hardware errors other than those noted in the previous paragraph 
are more serious in that they cannot normally be overcome by the 
program or the driver on its behalf. Some of these could be due to 
an operator fault, such as an omission to turn a paper tape reader on 
or to set the correct unit number on a DECtape transport. Once the 
operator has rectified the problem, the program could continue. 

Other errors, however, will require hardware repair or even software 
repair, e.g., if the program asks for Block 2000 on a device having 
a maximum of 1000. In general, all these errors will result in the 
driver placing identifying information on the processor stack and 
calling IOT to produce a trap through location 34. 

J This includes RF11 Disk: although this is basically word-oriented, it 
is assumed to be subdivided into 64-word blocks. 
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Under DOS, the Monitor provides a routine which prints a tele- 
printer message when this occurs. In a stand-alone environment, the 
program using the driver must itself contain the routine to handle 
the trap (unless the user wishes to modify the driver error exits 
before assembly) . The handler format will depend upon the program. 
Should it wish to take advantage of the information supplied by the 
driver, the format is as follows: 


(SP) : 
2 ( SP ) : 
4 (SP) : 
5 (SP) : 

6 (SP) : 


Return Address 
Return Status J 
Error No . Code 
Error Type Code : 


Stored by IOT Call 


generally unique to driver 
1 = Recoverable after Operator Action 
3 = No recovery 

Additional Informa- such as content of Driver, 

tion Control Register, Driver Identitv, 

etc . 


As a rule, the driver will expect a return following the IOT 
call in the case of errors in Type 1 but will contain no provision 
following a return from Type 3 . 


3.1.7 General Comment 

The source language of each driver has been written for use with the 
DOS version of the Assembler which requires certain statements which 
will not be accepted by the Paper Tape Software PAL-11A, in particu- 
lar: .TITLED -GLOBL. These should be edited out before the source 

is used. Similarly, an entry in the driver table gives the device 
name as . RAD50 ' DT ' to obtain a specially packed format used inter- 
nally by DOS. If the user still wishes to keep the name, for instance 
for identification purposes as discussed in section 3.3, . RAD50 

might easily be changed to .ASCII without detrimental effect, or it 
can be replaced with .WORD 0 . 


3 . 2 Drivers Assembled Separately 

Rather than assemble the driver with every program requiring its 
availability, the user may wish to hold it in binary form and attach 
it to the program only when loaded. This is readily possible; the 
only requirement is that the start address of the driver should be 
known or can be determined by the program. 

The example in section 3.1.2 showed that the Interrupt Servicing 
routine can be accessed through an offset stored in the Driver Table. 
The same technique can be used to call the setup subroutines, as 
these also have corresponding offsets in the Table, as follows: 



DRIVER+7 Open 1 

+10 Transfer 

+ 11 Close 1 

+ 12 Special Functions 1 


The problem, of course, is the start address. There is always 
the obvious solution, that of assembling the driver at a fixed loca- 
tion so that each program using it can immediately reference the 
location chosen. This, however, ceases to be convenient when the 
program itself has to avoid the area given to the driver. A more 
general method is to relocate the driver as dictated by the program 
using it, thus taking advantage of the position-independent nature of 
the driver. The Absolute Loader, described in the Paper Tape Soft- 
ware Handbook (DEC-ll-GGPB-D) , Chapter 6, provides the capability of 
continuing a load from the point at which it ended. Using this 
facility to enter the driver immediately after the program, the pro- 
gram itself might contain the following code to call the subroutine 
to perform the transfer illustrated in section 3.1.3: 

MOV 
ADD 
MOV 
ADD 


CMP 

MOV 

CLR 

MOVB 

ADD 

JSR 


PRGEND: 

.END 

This technique may be extended to cover situations in which 
several drivers are used by the same program, provided that it takes 
account of the size of each driver (this being already known because 
of prior assembly) and that the drivers themselves are always loaded 
in the same order. 


PC, Rl 

#PRGEND- . , Rl 
PC , R0 

#TABLE+12- . ,R0 


; GET DRIVER START ADDRESS 

GET TABLE ADDRESS 
& SET UP AS SHOWN 
. . .IN SECTION 3.1.3 


- (R0) , - ( R0 ) 

R0,@R1 

-(SP) 

10 (Rl) ,@SP 
(SP) + , Rl 
PC , @R1 


FINAL POINTER ADJUSTMENT 
STORE IN DRIVER LINK 
GET BYTE SHOWING... 
...TRANSFER OFFSET 
COMPUTE ADDRESS 
GO TO DRIVER 


For example, to access the second driver, the above sequence 
would be modified to: 

x If the routine is not provided, these are 0. 
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; GET DRIVER 1 ADDRESS 


MOV PC,R1 
ADD #PRGEND- . , Rl 
ADD #DVR1SZ,R1 ;STEP TO DRIVER 2 


DVRlSZ= 

PRGEND: 

.END 

An alternative method may be to use the Relocatable Assembler 
PAL-11S in association with the Linker program LINK-11S, both of which 
are available through the DECUS Library. The start address of each 
driver is identified as a global. Any calling program need, therefore, 
merely include a corresponding .GLOBL statement, e.g., .GLOBL DT. 

3 . 3 Device-independent Usage 

As mentioned earlier, the drivers are designed for use in a device- 
independent environment, i.e., one in which a calling program need not 
know in advance which driver has been associated with a table for a 
particular execution run. One application of this type might be to 
allow line-printer output to be diverted to some other output medium 
because the line-printer itself is currently not available. Another 
might be to provide a general program to analyze data samples although 
these on one occasion might come directly from an Analog to Digital 
converter and on another be stored on a DECtape, because the sampling 
rate was too high to allow immediate evaluation. 


As a rule, programs of this type should be written to cater for all 
the facilities that any one device might offer, but not necessarily all 
of them. For instance, the program should ask for start-up procedures 
because it may sometime use a paper tape punch which provides them, 
even though it may normally use DECtape which does not. As noted in 
section 2.1.1, the driver table contains an indication of its capabili- 
ties to cater for this situation. The program can thus examine the 
appropriate item before calling the driver to perform some action. As 
an example, the code to request start-up procedures might be (assuming 
R0 already set to List Address) : 


MOV 

#DVRADD,R1 

TSTB 

2 (Rl) 

BPL 

NOOPEN 

MOV 

R0,@R1 

CLRB 

"(SP) 

MOVE 

7 (Rl) ,@SP 

ADD 

(SP) +,R1 


GET DRIVER ADDRESS 
BIT 7 SHOWS. . . 

...OPEN ROUTINE PRESENT 
STORE TABLE ADDRESS 
BUILD ADDRESS 
...OF THIS ROUTINE 



JSR PC , CRl 


; . . . & GO TO IT 
; FOLLOWED POSSIBLY BY 

;WAI T AN D COMPLETION 

; PROCESSING 

NOOPEN: /RETURN TO COMMON OPERATION 


Similarly, the indicators show whether the device is capable of 
performing input or output or both, whether it can handle ASCII data 
or Binary data, whether it is a bulk storage device capable of support 
ing a directory structure or is a terminal-type device requiring 
special treatment and so on. Other table entries show the device 
name as identification and how many words it might normally expect 
to transfer at a time (in 16-word units) . All of the information may 
readily be examined by the calling program, thus enabling the use 
perhaps of a common call sequence for any I/O operation, as for 
example : 


WAIT: 


MOV 

#DVRADR, R5 

/SET DRIVER START 

JSR 

R5, IOSUB 

/CALL SET UP SUB 

BR 

WAIT 

/SKIP TABLE FOLLOWING ON RETURN 

.WORD 

10 

/TRANSFER REQUIRED 

.WORD 

103 

/BLOCK NO. 

.WORD 

BUFFER 

/BUFFER ADDRESS 

.WORD 

-256. 

/WORD COUNT 

. WORD 

404 

/READ FROM UNIT 1 

. WORD 

RETURN 

/EXIT ON COMPLETION 

.WORD 

0 

/ RESERVED 


; CONTINUE HERE . . . 

/WHILE TRANSFER IN PROGRESS 


IOSUB : MOV 

@SP ,R0 

/PICK UP DRIVER ADDR 

MOV 

R5 ,R1 

/SET POINTER TO LIST 

TST 

(Rl) + 

/BUMP TO COLLECT CONTENT 

. 


/ROUTINE CHECKS ON DEVICE 

. 


/..CAPABILITY USING Rl 

. 


;..T0 ACCESS LIST & 

. 


/ . . R0 THE DRIVER TABLE 

. 


/IF 0 . K . . . 

MOV 

@Rl , Rl 

/GET ROUTINE OFFSET 

ADD 

R0 , Rl 


CLR 

-(SP) 

/USE IT TO BUILD 

MOVB 

@R1 , @SP 

/ . . .ENTRY POINT 

ADD 

R0,@SP 


JSR 

PC , @ (Sp ) + 

/CALL DRIVER 

RTS 

R5 

/EXIT TO CALLER 


The calling program, or a subroutine of the type just illustrated 
may also wish to take advantage of a further feature mentioned earlier: 
the fact that when a driver is already occupied its first word must be 
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non-zero. The driver itself does not clear this word except in 
special cases shown in the description for the driver concerned. If 
the program itself always ensures that it is set to zero between 
driver tasks, this word forms a suitable Driver-busy flag. Under DOS, 
in fact, the program parameter list is extended to allow additional 
words to provide linkage between lists as a queue of which the list 
indicated in the driver first word is the first link. 

The preceding paragraphs are intended merely to indicate 
possible ways of incorporating the drivers available into the type of 
environment for which they were designed. The user will probably 
find others. However, he should read carefully the more detailed 
description of the driver structure in Appendix A and the individual 
driver specifications before determining the final form of his program. 

In particular, one general word of warning is appropriate here. 
Although most drivers normally set up an operation and then wait for 
an interrupt to produce a completion state, there are some cases in 
which the driver can finish its required task without an interrupt, 
e.g., "opening" a paper-tape reader involves only a check on its 
status. Moreover, where "Special Functions" are concerned, the 
driver routine may determine from the code indicated that the function 
is not applicable in its case and will, therefore, have nothing to do. 
In those cases, the driver clears the intermediate return address from 
the processor stack and takes the completion return immediately. 

Special problems may arise, however, if the driver concerned may be 
covering several tasks, any of which may cause a queue for the 
driver's services under DOS. To overcome these problems, the driver 
expects to be able to refer to flags outside the scope of the list 
described so far. This may mean that a program using such a driver 
may also need to extend the list range to cover this possibility. 
Extreme care will then be needed. 
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APPENDIX A 


T-0 DRIVERS WITHIN THE DISK OPERATING SYS TEW 


The principal function of an I/O driver is to satisfy the requirement 
of a Monitor processing routine for the transfer of a block of data in 
a standard format to or from the device it represents. This will in- 
volve both setting up the device hardware registers to cause the trans- 
fer and its control under the interrupt scheme of PDP-11, making due 
allowance for peculiar device characteristics (e . g . , conversion to or 
from ASCII if some special code is used) . 

It may also include routines for handling device start-up or 
shut-down such as punching leader or trailer, and for making available 
to the user certain special features of the device, such as rewind 
of magtape. 

A. 1 Driver Structure 

In order to provide a common interface to the monitor, all drivers 
must begin with a table of identifying information as follows: 


BUSY FLAG (initially 

v) i 

FACILITY INDICATOR (expanded below) 

Offset to 

Interrupt Routine* 

Standard Buffer Size 
in 16-word Units. 

Offset to 

OPEN Routine * 

Priority for 

Interrupt Service 

Offset to 

CLOSE Routine * 

Offset to 

Transfer Routine * 

Space 

Offset to 

Special Functions* 

DEV 

NAME (Packed Radix-50) 


Offsets marked * will enable calling routine to 
indicate routine required. They will be con- 
sidered as an unsigned value to be added to the 
start address of the driver. This may mean that 
with a 256 maximum, the instruction referenced 
by the offset will be JMP or BR (routine) . 


Bits in the Facility Indicator Word define the device for moni- 
tor reference: 
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SPECIAL STRUCTURES 


GENERAL STRUCTURE 


A 


A 

File- I 
Structured 


Device DEC- 
tape (or 
similarly 
reversible) 


^ A 


Unused 

"Terminal" 

Device 

Contains OPEN — 
Contains CLOSE 


Contains SPECIAL* 


Multi 
User 

Output 
Device 

Input Device 


Binary Device 
ASCII Device 


The table should be extended as follows if the device is file- 


s true tured : 


BLOCK USED AS MASTER FILE DIRECTORY 


POINTER TO BIT-MAP IN MEMORY 



Unit 0 

Similar Bit-Map 
Pointers for 
Multi-unit 
Devices 


The driver routines to set up the transfer and control it under 
interrupt, and possibly for OPEN, CLOSE, and SPECIAL, follow the 
table. Their detailed operation will be described later. 

A. 2 Monitor Calling 

When a Monitor I/O processing routine needs to call the driver, it 
first sets up the parameters for the driver operation in relevant 
words of the appropriate DDB 1 , as follows: 


XYZ: 


SPECIAL FUNCTION CODE 

DEVICE BLOCK NUMBER 

MEMORY START ADDRESS 

WORD COUNT (2's Complement) 

TRANSFER FUNCTIONS (expanded below) 
COMPLETION RETURN ADDRESS 


(DRIVER WORD-COUNT RETURN) Set to 0 



(User Call Address) 
(User Line Address) 


1 Dataset Data Block - in full, a 16-word table which provides the main 
source of communication between the Monitor drivers and a particular set 
of data being processed on behalf of a using program. 
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The relevant content of the Transfer Function word is as follows: 


TT Echo Control 


T 


Used by Driver 
to indicate 
Hardware Parity 
Fail 



DECtape 

reverse 


DEVICE 

UNIT 


t 


/'0=ASCII 
\l=l 


Transfer 


Binary 
Transfer OUT 
IN 


Provided that the Facility Indicator in the Driver Table de- 
scribed above shows that the driver is capable of satisfying the re- 
quest, both from the point of view of direction and mode and of the 
service required, the Monitor routine places in Register 0 the relative 
byte address of the entry in the Driver Table containing the offset to 
the routine to be used (e.g., for the Transfer routine, this would be 
10). It then calls the Driver Queue Manager, using JSR PC,S,CDB. 

The Driver Queue Manager ensures that the driver is free to 
accept the request, by reference to the Busy Flag (Word 0 of the 
driver table) . If this contains 0, the Queue Manager inserts the 
address of the DDB from Register 0 and jumps to the start of the 
routine in the driver using Register 1 content to evaluate the address 
required. If the driver is already occupied, the new request is 
placed in a queue linking the appropriate DDB 1 s for datasets waiting 
for the driver's services. It is taken from the queue when the driver 
completes its current task. (This is done by a recall to the Queue 
Manager from the routine just serviced, using JSR PC,S.CDQ.) 

On entry to the Driver Routine, therefore, the address following 
the Monitor routine call remains as the "top" element of the processor 
stack. It can be used by the driver in order to make an immediate 
return to the Monitor (having initiated the function requested) , using 
RTS PC. It should also be noted that the Monitor routine will have 
saved register contents if it needs them after the device action. The 
driver may thus freely use the registers for its own operations. 
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When the driver has completely satisfied the Monitor request, 
it should return control to the Monitor using the address set into 
the DDB . On such return, Register 0 must be set to contain the 
address of the DDB just serviced and since the return will normally 
follow hardware interrupt, Registers 0-5 at the interrupt must be 
stored on top of the stack. 

A. 3 Driver Routines 
A . 3 . 1. TRANSFER 

The sole purpose of the TRANSFER routine is to set the device in 
motion. As indicated above, the information needed to load the hard- 
ware registers is available in the DDB, whose address is contained in 
the first word of the driver. Conversion of the stored values is, 
of course, the function of the routine. It must also enable the 
interrupt; however, it need not take any action to set the interrupt 
vectors as these will have been preset by the Monitor when the driver 
is brought into core. Having then given the device GO, an immediate 
return to the calling processor should be made by RTS PC. 

A. 3.2 Interrupt Servicing 

The form of this routine depends upon the nature of the device. In 
most drivers it will fall into two parts, one for handling the term- 
ination of a normal transfer and the other to deal with reported 
error conditions. 

For devices which are word or byte-oriented, the routine must 
provide for individual word or byte transfers, with appropriate 
treatment of certain characters (e.g., TAB or Null) and for their 
conversion between ASCII or binary and any special device coding 
scheme/ until either the word count in the DDB is satisfied or an 
error prevents this. On these devices, the most likely cause for 
such error is the detection of the end of the physical medium; its 
treatment will vary according to whether the device is providing 
input or accepting output. The calling program will usually need to 
take action in the former case and the driver should merely indicate 
the error by returning the unexpired portion of the word count in 
DDB Word 7 on exit to the Monitor. Output End of Data, however, 
will, in general, require operator action. To obtain this, the 
driver should call the Error Diagnostic Print routine within the 
Monitor by: 
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; SHOW DEVICE NAME 
; SHOW DEVICE NOT READY 
; CALL E.D.P. 


MOV DEVNAM, - ( SP) 
MOV #402 , 0 (SP) 
IOT 


On the assumption that the operator will reset the device for further 
output and request continuation, the driver must follow the above se- 
quence with a Branch or Jump to produce the desired resumption of the 
transfer. 

Normal transfer handling on blocked devices Cor those like RFll 
Disk which are treated as such) is probably simpler since the hardware 
takes care of individual words or bytes and the interrupt only occurs 
on completion. Errors may arise from many more causes, and their 
handling is, as a result, much more complex and device dependent. In 
general, those which indicate definite hardware malfunctions must 
lead to the situation in which the operator must be informed by 
diagnostic message and the only recourse after rectification will be 
to start the program over. 

At the other end of the scale there are errors which the driver 
itself can attempt to overcome by restarting the transfer - device 
parity failure on input is a common example. If a retrial, or 
several, still does not enable a satisfactory conclusion, the driver 
should normally allow programmed recovery and merely indicate the 
error by Bit 17 of DDB word 5. Nevertheless, because the program may 
wish to process the data despite the error, the driver should attempt 
to transfer the whole block requested if this has not already been 
effected. Between these two extremes, the remaining forms of error 
must be processed according to the type of recovery deemed desirable. 

Whether the routine uses processor registers for its operation 
or not will naturally depend on considerations of the core space saved 
against the time taken to save the user's content. However, on 
completion (or error return) to the Monitor, as indicated in an earlier 
paragraph, the calling routine expects the top of the stack to contain 
the contents of all Registers 0-5 and Register 0 to be set to the 
address of the DDB just serviced. The drive must, therefore, provide 
for this. 

A. 3. 3 OPEN 

This routine need be provided only for those devices for which some 
hardware initialization is required by the user. It should not 
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normally appear in drivers for devices used in a file-oriented manner. 
Its presence must be indicated by the appropriate bit (Bit 7) in the 
driver table Facility Indicator. 

The routine itself may vary according to the transfer direction 
of the device. For output devices, the probable action required is 
the transmission of appropriate data, e.g., CR/LF at a keyboard 
terminal, form-feed at a printer, or null characters as punched leader 
code, and for this a return interrupt is expected. The OPEN routine 
should then be somewhat similar to that for TRANSFER in that it merely 
sets the device going and makes an interim return via RTS PC, waiting 
until completion of the whole transmission before taking the final 
return address in the DD3. 


On the other hand, an input OPEN will likely consist of just a 
check on the readiness of the device to provide data when requested. 

In this case, the desired function can be effected without any interrupt 
wait. The routine should, therefore, take the completion return immed- 
iately. Nevertheless, it must ensure that the saved PC value on top 
of the stack from the call to S.CDB is appropriately removed before 
exit. In the case of drivers which can only service one dataset at a 
time (i.e.. Bit 0 of their Facility Pattern word is set to 0) and can 
never, therefore, be queued, it will be sufficient merely to use 
TST (SP)+ to effect this. A multi-user driver, however, must allow for 
the possibility that it may be recalled to perform some new task al- 
ready waiting in a queue. This is shown by the byte at DDB-3 being 
non-0. In this case, the intermediate return to the routine originally 
requesting the new task has already been made directly by S.CDB. The 
address now on top of the stack is the return to the routine, whose 
task the driver has just completed and which has called S.CDQ to 
dequeue the driver. This return must be taken when the first routine 
has performed its Completion Return processing. Moreover, this first 
routine expects to exit as from an interrupt. When a driver is recalled 
from a queue, it must simulate this interrupt. A possible sequence 
might be: 



MOV 

DRIVER, R0 

; PICK 

UP DDB ADDRESS 


MOV 

(SP) +,R5 

; SAVE 

INTERIM RETURN 


TSTB 

-3CR0) 

; COME 

FROM QUEUE? 


BEQ 

EXIT 




MOV 

@#177776, -(SP) 

; IF SO 

, STORE STATUS 


MOV 

R5,- (SP) 

; . . . & 

RETURN 


SUB 

#14, SP 

; DUMMY 

SAVE REGS 

EXIT: 

JMP 

@14 (R0) 
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A. 3.4 CLOSE 


As with OPEN, this routine should provide for the possibility of some 
form of hardware shut down such as the punching of trailer code and 
is not necessary for file-structured devices. Moreover, it is likely 
to be a requirement for output devices only. If it is provided, 

Driver Table Facility Indicator (Bit 6) must be set. 

Again, the probable form is initialization of the hardware action 
required, with immediate return via RTS PC and eventual completion 
return via the DDB-stored address. 

A. 3.5 SPECIAL 

This routine may be included if either the device itself contains the 
hardware to perform some special function or there is a need for 
software simulation of such hardware on other devices, e.g. , tape 
rewind. It should not be provided otherwise. Its presence must be 
indicated by Bit 5 of the Facility Indicator. 

The function itself is stored by the Monitor as a code in the 
DDB as shown earlier. When called, the driver routine must determine 
whether such function is appropriate in its case. If not, the 
completion return should be taken immediately with prior stack clear- 
ance, as discussed under OPEN. For a recognized function, the 
necessary routine must be provided. Again, its exit method will 
depend upon the necessity for an interrupt wait or otherwise. 

A. 4 Drivers for Terminals 

The rate of input from terminal devices is normally dictated externally 
by the operator, rather than being program-driven; moreover, for both 
input and output, the amount of data to be transferred on each 
occasion may be a varying value, i.e., a line rather than a block of 
standard size. Furthermore, there may be problems with the conflict 
between echo of input during output. As a result, drivers for such 
devices will demand special treatment. 

Normal output operation, i.e., .WRITE by the program, is handled 
by the Monitor Processor. On recognizing that the device being used is 
a terminal, as shown by Bit 8 of the facility indicator, this routine 
always causes a driver transfer at the end of the user line, even 
though the internal buffer has not been filled. The driver, however, 
is given the whole of a standard buffer, padded as necessary with 
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nulls. Provided the driver can ignore these, the effect is that of 
just a line of output. 

Input control on the other hand, must remain driver responsibil- 
ity. Overcoming the rate problem will, in most cases, require circu- 
lar buffering within the driver until demanded by the Monitor. At 
this point, transfer of data already in should occur. If this is 
sufficient to fill the monitor buffer, the driver can await the next 
request before further transfer onward. If insufficient, it should 
operate as any other device and use subsequent interrupts to continue 
to satisfy the Monitor request. It must, nevertheless, stop any 
transfer at the end of a line in normal operation. In order to allow 
the Monitor to continue, the driver must simulate the filling of the 
buffer by null padding (of no consequence, since terminals are by 
nature character-based) . (Normal operation, of course, means response 
to user .READ'S and is indicated by the size of the buffer to be 
filled, namely the driver standard. Should the user be requesting 
.TRANS, the buffer size will vary from the standard in all likelihood 
and the driver may then assume he requires operation as a normal 
device -- complete buffer fill-up before return.) 

Where input echo is a further complexity, there will doubtless 
be other requirements. If the echo is made immediately after the 
input, it may be desirable to have a second buffer to cacer for the 
likely situation that the echo will not exactly match its origin. 

On the other hand, if the echo is held for any length of time, perhaps 
to provide correct relations between program-driven output and the 
echo, the second buffer could be too expensive, A larger input buffer 
and routines to allow for several outputs to one input character while 
sitting on that character might be more convenient. The conflict 
between such echo and program-driven output will require controlled 
switching within the driver input and output handlers. 
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DRIVER for TC1I DECtape Control 


The principal function of the TC11 Driver is to transfer data between 
the hardware control and a memory area specified by a calling Monitor 
routine on behalf of a user program. The number of words transferred, 
the DECtape transport, the absolute starting block on the tape, and 
the direction of tape travel in each case are all determined by the 
calling routine. 

As required by the standard Monitor-driver interface for all de- 
vices in general and, as DECtape will be handled as such, for file- 
structured devices in particular, the first part of the driver consists 
of two consecutive tables: 

a) Table of descriptors and pointers to routines included. 

b) File-structured usage data 

All data transfers utilize the normal read/write capability of 
the PDP-11 NPR facility. The driver contains a set-up sequence to 
initiate a search for the requisite start block and routines then to 
handle interrupts for continuation of such search and, if this is 
successful, the subsequent data transfer specified. 

As a file-structured device, the opening and closing of files 
are the responsibility of the Monitor file management routines. There 
are therefore no OPEN or CLOSE routines. 

Also, no routine to handle SPECIAL FUNCTIONS is currently pro- 
vided. This could be added later if it is found desirable to simulate 
the normal operation of some similar device, e.g., rewind as for Mag- 
netic Tape. 

1. Initial Tables 


Relevant entries for this driver are as follows: 


WORD 0 : = 0 initially-set to address of DDB for dataset being ser- 

viced when busy, by calling routine. 

WORD 1: = Facility Pattern = 140037 signifying: 

a) File-structured Device 

b) DECtape (or similar reversible medium) 
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WORD 2 : = 

WORD 3 : = 

WORD 4 : = 

WORD 5 : = 

WORD 6 : = 

WORD 7 : = 

WORDS 10-17: 


c) Capable of Input or Output in either ASCII or Binary 
on more than one dataset at a time. 

a) Standard Buffer Size = 16 X 16-word units (i.e., 1 
standard DECtape block) . 

b) Offset to Interrupt Service routine. 

a) Priority for Interrupt Service = 7 

b) 0 [No OPEN routine included] 

a) Offset to TRANSFER Set-up routine 

b) 0 [No CLOSE routine included] 

0 [No SPEC FUNC routine presently] 

Name ' DT' in RADIX 50 format. 

Start Block of Directory Structure = 100 

= Reserved for pointers to in-core Bit Maps for each of 
8 transports supportable by TC11. 


2 . Processing Routines 


2 . 1 Transfer Set-up 

A Monitor routine effectively calls for transfer set-up by JSR PC, XXXX 
where XXXX is the start address evaluated from the offset in WORD 4 of 
the table. The address of the DDB containing relevant parameters will 
be stored in WORD 0 of the table. 


The set-up routine will first set a counter for the number of re- 
turns to be made in the event of parity or timing failures in tape 
operations (8-9). Using the given DDB address, it then extracts the 
following information and actions it as shown: 


(i) Block No. (DDB+4) - two copies are stored internally as con- 

trols during Start Block search as detailed below. 

(ii) Word Count & Memory Address (DDB+6 & 10) - these are stored 

immediately in the TC11 WC & BA registers for use 
as soon as the Start Block has been found. 

(iii) Function (DDB+12) - the requirement for Read or Write is con- 

verted from the standard Monitor specification (4 
or 2) into the corresponding DECtape value (4 or 
14) and stored internally until completion of block 
search. 

(iv) Tape Unit & Motion (DDB+13) . The bits showing these are as- 

sociated with the DECtape Search function [3] and 
are set into the TC11 Control Register to initiate 
the search for the start block. 



The set-up routine also sets two switches appropriately: 


.q) In_any transfer, two types of inte rrupt ma y occur ; the 

first at each block encountered during the search for 
the start specified; the second thereafter arising when 
the transfer has been completed. The switch is initial- 
ly set for the first type. 

b) The tape is started in the eventual transfer direction. 
Turn-around, however, may be necessary if the tape is 
badly positioned. The second switch is set initially 
to reflect the start direction in order to provide ade- 
quate control during such turn-around. 

The driver then sets the TCii Control Register for the search, and 
restores control to the calling Monitor routine, via RTS PC, to await 
its first interrupt. 

As permitted by the General Driver Spec, the set-up routine makes 
full use of the processor registers, without saving or restoring their 
original content. 

2 . 2 Interrupt Servicing - Search Mode 

Provided that a tape block-mark is encountered without error, the 
search interrupt servicing routine compares the number found (from 
TC11 Data Register) with one copy of that for the required block, 
stored internally by SET-up. If the comparison shows that current tape- 
motion will eventually lead to the required block, the routine exits 
immediately and waits for a subsequent interrupt to show that the 
transfer may begin. 

If tape-motion is in the wrong direction, the routine resets the 
TC11 Control register to produce tape turn-around on exit. A second 
turn-around will now be essential for a transfer in the require direc- 
tion. The routine therefore modifies, appropriately, by 2 the copy of 
the block number required used in the comparison. This factor is pro- 
vided so the tape is sufficiently positioned beyond the block required 
to ensure that it will be up to speed at the right point after the sec- 
ond turn. For example, in order to transfer Block 100 forward, the 
first turn will seek Block 76 in reverse. 

An equal comparison might then result after a single turn-around. 
The block number found is, therefore, checked against the second, un- 
modified, stored value. If not equal, a turn-around has occurred: the 
TC11 is reset for the second time and the first stored number is re- 
stored to its original value. When both stored values and the block 
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found are all equal, the correct tape travel is assumed and the trans 
fer is effected by moving the stored function into the TC11 control 
(byte only to avoid hardware delay imposition) . The interrupt switch 
is changed to show that the operation is now in Transfer Mode. 

In the event of an error in Search Mode, the TC11 Test Register 
is examined. If this shows that the cause is "End Zone Reached", the 
turn-around procedure is again effected, since such a condition is 
initially the same as being, for example, at Block 102 when 100 is 
wanted forwards. All other hardware-reported errors are treated as 
discussed in a subsequent paragraph. 

Another type of error may occur but this can only be detected by 
software, i.e., a failure to find the block either because its number 
on the tape is corrupted or the one required is outside the range of 
the tape. For both situations the tape might rock endlessly owing to 
the turn-around algorithm. The search interrupt processor therefore 
counts the number of times a turn is effected. It gives up at the 
sixth attempt and requests printing of an F016 message with the fail- 
ing Block Number as evidence. 

To avoid unnecessary time wastage in the storage and retrieval 
of their contents, the normal search interrupt processing does not 
use processor registers. 

2 . 3 Interrupt Servicing - Transfer Mode 

The normal cause of an interrupt in transfer mode is the satisfactory 
completion of the whole of the data transfer specified. The driver 
must then recall the monitor routine which requested the transfer. 
Because this routine may have surrendered control to the user program 
during the period of the search and transfer operations, the driver 
must assume such is the case and save all register contents before 
setting R0 to the DDB address from its WORD 0 and taking the completion 
return set into DDB+14. 

The interrupt may also occur if an error is determined by examina- 
tion of the TC11 Test Register. In Transfer Mode, two types of errors 
specifically processed are Party or Timing Failure. Following either 
of these, the servicing routine restarts the whole process over from 
the original block search until at least 8 attempts to produce a satis- 
factory transfer have been made. If these all fail, the routine re- 
turns a flag indicating the error in Bit 15 of the relevant DDB+12. 
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It checks, however, whether the failure occurred at an intermediate 
block of a transfer involving several blocks. If such is the case, it 

e ndeavors to provide a sat isf actory transfer of the remaining bloc ks . 

It then recalls the monitor at the completion return address. 

Of the other types of error, transfer mode servicing also handles 
Non-existent Memory and End Zone. Both of these conditions are assumed 
to be the result of a programming error and cause printing of a fatal 
error message F015 with User Call Address as evidence. 

2 . 4 Recoverable Errors 

In both Search and Transfer modes, for errors not especially noted, a 
general routine is used to request printing of a diagnostic message 
requesting operator action. SEL and ILO errors are assumed to indicate 
a "Device Not Ready" state for which the device name (DT) is support- 
ing evidence for the message ' A002'. For the rest, and Mark Track 
Errors in particular, which might be resolved by changing tapes — the 
message 'A003 1 is printed with the TC11 Test Register content as 
evidence. For all these errors, the operator might request program 
resumption by a Monitor "Continue" command. The driver restarts the 
whole search and transfer process if this occurs. 

3 . Implementation 

a. Comments on the driver listing show general methods of imple- 
mentation. It should be noted, however, that in several in- 
stances, in-line code is modified. In particular, the two 
switches mentioned under "Setup" are variable Branch Instruc- 
tions and the internal storage of data has already been in- 
dicated. This means first that the driver is not reentrant - 
an unlikely requirement when one control may only service the 
transport at a time, even though eight may be attached to it. 

In the second place, the driver, as written is not immediately 
usable in a ROM. 

b. The priority level for interrupt servicing should also be 
mentioned. The hardware level is 6; the initial software 
level, however, is set at 7. This is to ensure that there 
will be no delay due to any other interrupt in the critical 
case in which the required block number has been found and a 
change of function from Search to Read or Write must occur 
within 400 msecs. The interrupt routines themselves lower 
the level to 6 , if the critical case is not being actioned. 

This will mean that other interrupts may be delayed up to 

50 msecs, in the worst case, the critical one. 

c. A further minor point of interest is that the tape is always 
stopped at the end of each transfer (or when an error occurs 
to prevent this) in order to maintain correct tape position- 
ing. A program STOP request is issued to effect this in all 
cases, even though the hardware may be set up to provide for 
it. However, resetting the TC11 Status Register for this 
purpose can remove error conditions. The content of this 
register is, therefore, examined (or is saved for later 
examination) before the STOP command is given. 
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4. Program Listing 

A complete assembly listing of the driver follows. 

:C0PY®IGHT 1971, DIGITAL FO JI»MFNT CO»P., M A V *J A D D # MASS, 




? V 1 6 S T 0 Nl 

•lljORFH* 

VO01 A 




? 

.TITLE 

Dt 




. GLOBL 

or 




; 0 ECTAPF 

7PXVFR 

VERSION 

1 23 JULY 70 



• 

# 

PRESENTLY CONTAINS ONLY 

ROUTINE FOR TRAMSFFR 



a 

•STANDARD DRIVER 

table? 



1 f fl * t -1 

IT; 

.WORD 

A 

? BUSY FLAG (DOB ADDR WHEN BUSY) 

AOs (t'KA? 

7 3 7 


. 1YTE 

37,300 

jFACILITY IMOICATOR 

£1 0 t' 7 K> *5 

37(2 





A M li'j 0 4 

7 2 0 


• * Y T E 

16. 

? STD B'JFF SIZE/16, 

4 i '. if a 0 F> 

3 1 i> 


• 3 Y Tfc 

or. jnt-oi 

? P 0 1 N T F R TQ I NJT SVCE 

w $ 0 o y * 

347 


.3YTE 

340 

? I N T SVCF PRIDRTTY 

400*07 

070 


. 3 Y T t 

0 

?DE-S PATCH TARLE .... 

0 P 0 * i p 

t- 4 0 


• 7 Y T E 

DT.TFP-DT 

?.,,FDR TRANSFER ONLY! 

0 W 1 1 

000 


• * Y T E 

0 


00001 ? 

7*7 


.BYTE 

0 


00 0 'M3 

£■ »k* 


• 3 y T E 

y 

f S P A R E 

0001 1 4 

* 1 6 0 4 0 

}T,ma m : 

,RAR5f> 

1 nj 1 


000*1 6 

*t*P 1 *0 


. 4QPD 

DT, DIR 

?FIYEO MFO PLOCK 

000*20 

0**0 * 0 


. -'HRD 

A , P , 0 , 0 , 0 , 0 , (4 , P 

J P 0 1 N T E ° S FOR BIT MAP ACCESS 

0 '//■*? ? 

* 0 *. 0*0 






* 0*0 510 





0000 2 * 






000030 

* f" * 0 * 0 





000032 

00*7 If 





■4P 0 0 34 

00*0 *fe> 





0 0 (t 1 0 3 6 

■’ 7 7 V. .7 0 







? PEG! STEP A-SSTG* 

MFNTSi 



* 2 PL '‘12 

R r> = *40 





M 0 ft [*. t 4 J 

R1 3 7,1 





10P732 

0 if P 0 * 3 

R 2 a % 2 

R 3 a % 3 





ft 0 0 3 

R4s%4 





00 700 5 

RSa^S 





o 0 O £-.*6 

SP *'*6 





■1 0 01 0 0 ! 7 

PC *77 






•SET Up 

TRANSFER 

« 


000*14* 

*1 1767 
* y * 4 4 4 

UT.TpPx 

MOV 

«*PC,DT.RTC 

t SET RETRY COUNT 

0 55 t-l 0 4 4 

016700 

177730 

dt.or! : 

MOV 

QT,R0 

?GET ADDRESS OF DOS ... 

000-057 

*127*1 

177346 


MOV 

#!3T, CBA# Rl 

?... & OF HWR BLOCK 

0 P.0054 

00 * 0 ii 


CIR 

?P 1 


0 0 0 41 J> 6 

*??020 


C IP 

C W + , (R0D+ 

?SKTP USER LINE IN DDR 

070767 

712067 

* 0 * 2*2 


MOV 

(»£)+, DT, PRO 

?SAVE BLOCK NO FOR LATER 

070764 

012 LM 1 


MOV 

(R0)+,0R1 

? SET READY MEMORY ADDS ... 

i'i (•' 0 7 6 6 

712041 


HOV 

(W+#-(Rl ) 

% WORD COUNT 

07077? 

Ufn.57 

00021 4 

DT.PR2: 

CLRB 

dt.int 

? SET INT’RUPT SW, TO SRCH 

077*74 

*16757 

700166 

300166 


MOV 

DT , PRO, OT.BCK 

? SET RLK CTRL FOR SRCH 

070 Id? 

OI2773 

7 01 : O 1 P 0 


MOV 

a 1M0,R3 

1 USED I.N n E xt SEQUENCE 
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4* 

0103*7 

1 ^ Cl i ? 0 

MOV 

R3,nr.TAC 

* ^ « t rt % 

j St T TIJPB A p QI!ND CDUNiT 

■4 P t j 1 1 2 

1 1 1 '.: J o 

M 0 V 

•*R0»"c5'J 

f Hr T UN IT# H J R fc C T IQ N X Fl-MC 

I-* 

^ 4 ? 7 1 e 

1 ,7 f *J4i 

BTC 

U 1 7 M 3 4 1 , 9 S P 

? C L £ A R ?OSS. GARBAGE 

£ 1001 .2* 

*60316 

BIS 

R-3# *SP 

jADD IN INT ENB PIT 

4 0*1 2? 

1 3 1 f 1 7 

BITS 

*SP, 0PC 

•write RFDD? 

w D 1 2 4 

;> & 1 4 ? g 

6 EQ 

. + 6 

jCPFAD n.K, alrdy 1 ***** 

0 0 if) 1 2 * 

062716 

A^O 

* 12 , £SP 

i IF $D GET DECTAPF. fcuiv. 

0001 3? 

V- v I' l <r 

111657 

0 £ 0 > 1 4 4 

M 4 V « 

sSPfOT.FRC 

j S A V F F 1 > N C FOR t A T E =? 

00013* 

1 1 1716 

d n v r 

£ p C • *Sp 

J RESET FIJNC TO SPCH C I N T EPS) 

4 1 ,* ti 1 4 ^ 

•V63 r, 3 

A 3L 

R3 

j (NOW CONTAINS 2?1)***** 

0 w 014? 

3 1 627 

004000 

BIT 

#SP»#4(W 

? travel forward? 

0 0 014* 

U 1 100 1 

BMP 

.+4 


30 01 5- 

">05233 

INC 

R3 

j IF SO R3 NOW 231 & SO ... 

«> c* i>j 1 5 2 

U ?367 

3 fe flic. 2 3 

M n v R 

R 3 , R T • S 8 w 

jMAKIMG B p L OR BP I AS RFQD 

;<) ( W 15* 

r 1 1 ? 6 4 1 

MTV 

( 8 P)+r-fRl) 

t SET OFCTAPE CONTROL 

VPU16? 

00 02 ? 7 

RTS 

• ****★ r a r f 

: INTERRUPT S 

PC 

USED AS LTTFRAL by 

FPVTCP C A) - SF ARCH 

j RETURN TO CALLER FOR NOW 

RRFVIOUS INSTRiJCTIONUI 

I i PRORESSs 

£00162 

">05737 

17734? 

DT.3IPS T3T 

®«DT.CC M 

JCHFCW STATUS 

003 16 * 

10*473 

y 1 1 

OT.SF® 

; T F ERROR GO INVESTIGATE 

3"t 1 7 f * 

> ? 3 7 * 7 

1 7 7350 

•1 0 * 0 7 1 > 

C IP 

a«DT.CDT, HT.BPO 

jCMFC* BLOCK POUND 

001-1 1 7* 

Hf 14 32 

BE a 

QT.BrD 

i IF ONE RFQD, GO ACTION 

%vx?yn 

U"*4?6 

1 

B-iI 

jT.SSWe.-t 

OT.RXT 

•GET TO BLOCK TP IS WAY? 

} f B°L TE TRAVEL BACKWARD) 

/. ^ 0 ? 0 ? 

1 42737 

* 1 / ‘ ’ > 4 k: 

177776 

) r . T A 1 S H T c 3 

#4P , »a i 77776 

jOPC.R PRIORITY 

000310 

17*227 

* 7 0 0-10. 
*fc*2t2 

A3R* 

jT.TAC=.-2 

#3 

SHOW MANY TURNS? 

0 0 0 ? 1 4 

1 03*1 7 

BCS 

OT.BFP 

Sir 6 CAN’T FIND BLOCK 

000 ? 1 * 

*12746 

fjf-i A rv, r *\ u 

T TV 

#4en«5#-(SP) 

f OTHERWISE MUST TURN AROUND 

000 ??? 

v Q k 1 1 

1 1 2746 

'’‘Pflp-flg 

MTV 

»o,-CSp) 

j ASSUME TRAVEL HOW F*D 

000 ??* 

1 0-6067 
177747 

RORB 

DT.SSW 

;CHE C< DIRECTION 

0"0?3? 

103433 

BCS 

0T.TA2 

; IF FWO OMIT NEXT 

*HV?34 

'‘.064 66 

0000 : 12 

MEG 

2CSP) 

jIE BUD, REVERSE EVERYTHING 

3 C . (-: ? 4 '* 

*06416 

NEG 

®SP 


200P4? 

162667 

30^020 

9 T . T A 2 i S JB 

(SP)+,DT.BPO 

f ALLOW ? BLKS FOP 2ND TURN 

•'*00?4* 

i_1 6 2 6 3 7 

1 7734? 

A 3p 

( S P 3 + f # £ P T . C C M 

sSWTTCH STATUS 

307252 

1 06167 
177723 

POL* 

DT.SSW 

1 RE SE T DIR SM CC BIT REVERSES) 

000256 

106237 

177342 

QT.SXT; INCH 

««DT.CC K 1 

j CONTINUE SEARCH 

070?6? 

f* 0 l)i 2’ fl 2 

RTI 


j W AIT NEXT BLOCK 
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;3L3C« 

FOUND - 

r HFCV TpAVE-t CORRECT? 

0 U ? 6 4 

022727 

^ if 1 ^ lc^ £ 

51 00 0 30 

.) T . B F 0 j 

C *P 

#3, «0 

yTPAVFL as ORIGINALLY storfd? 


H: 5*266 

OT.PROs 

.-4 




*00270 

3T. 3CK= 

. "2 



v p ijji ? 7 2 

'VI 343 


BNE 

QT.T Al 

: T F NOT MUST TURN AO A T N 


1052*7 

300010 


INCH 

0 T , I N T 

; RESET I NT 1 PUP T SW FOR TFP 

0 « £ 3 b f* 

1 12737 

.1 ,> ft -i j- . 


MOVB 

# i,».ftDT.CCM 

: M 0 V E T u CORRECT FUNC 


• *'■ v? r 

1.77342 

V'P3^2 

UT.FROc 

,-4 



?! 0 g! 3 0 f 

4 - i 0763 


BR 

DT.SXT 

?v 00 SFT UNDER may 



; TNTEPR 

: «p T SERVICE CB) - TRANSFER COMPLETE (?): 

00^31 r 

V r, M’V, 

)T.INT: 

MR 

.+2 

. INTERRUPT SWITCH . ... 

,? 0 «> 3 1 2 

'*00723 


BR 

DT , S I P 

I FQP SPCH COMES HERE 1 

■A C* v . Ml 4 

142737 
00004 0. 

1 77776 


B T C -'1 

177776 

. npnp PRIORITY 

00032? 

0 137 46 

0 4 4 


M 1 y 

fl»^V.RSAV,-(3P) 

•on transfer complete , ,, 

000326 

304536 


JSR 

R*5,<*CSP) + 

t SAVE USER REGISTERS 

v.i 0 y.i 3 3 ? 

M67 V- 

1 774 44 


MOV 

DT,P0 

; GET 0[)B AODR 

0023 3-4 

''* 12721 

1 77342 


M-iy 

fot.ccm,ki 

I SET STATUS ADOR 

0 0 b 3 4 o 

'M?7 03 
V-0 0 1 t> 


M 1 v 

ft 1 b r R 3 

r SET MAGIC CONSTANT 

T44 

17571 1 


1ST 

«? 1 

; ERROR CAUSE TNT 1 RLJPT? 

A A >A 34 6 

1 0 0 4 b i 


b'U 

0T.TFP 

•TF SO 00 % SEE > HY 

2003b^ 

112311 


U 0 V R 

r:s,»r i 

• 0 T w 5 0 m 1 s E STOP TAPE ... 

00b 3b? 

■'*160 -4 7 

)T,TXTl 

.•1 1 v 

1 4(Pb) ,PC 

;... * TAKE complete. RETN 


V7r 14 

• SEARCH 

ERROR 

- OFTFRMIMF CA'JFF 

■ 

■0 0 0 356 

’i-57 37 

1 7734? 

ot.se 0 : 

T 3 T 

#^DT,TST 

t T N END ZONE? 

000 36? 

1 02737 


311 

DT.TAl 

;0,K, M F A * 1 S TURN AROUND 

b > • b 3 6 4 

1 427 17 
00P£ 40 

1 77776 


B I C B 

ft40,««i77776 

? r)P6P priority 

000372 

’13746 

1 f’ 7 0 44 


M f) y 

**V,RSAV,-(SP} 

! SAVE ALL USER REGS , 

0 p 0 376 

*04536 


JSR 

R5, *(SP)+ 


3f*£<Ag|P 

M 2 7 '* 1 

1 773 40 


Ml V 

^ot.TBTfRl 

|GFT DECTAPE STATUS 

v t' 2 4 0 4 

U1 146 

)T.F*T; 

« ov 

P»1 ,-CSP) 

I S E T UP TO TELL USER 

i) 0 U 4 0 6 

012746 

« 06 4-1 4 


MOV 

FOT.IBF_,-fSP) 


■ 1004 1? 

7 3 2 7 2 1 
: M40‘V 


BIT 

#1 4013 3, CRD + 


4 0 04 16 

V 1 435 


MHO 

DT.?T P 

I.... IF SEl OR 1L0 

0 0042 o 

•312716 

M £ n 4 Cl 2 


MOV 

*0T.NRF, »SP 

1 DIAGNOSE TAPE FAULT OIFF, 

4 0 *.> 4 2 4 

716766 

1 77364 


MOV 

OT.NAM, SCSP) 

?... AS NOT READY 


--*rv7 2 





00043? 

112711 

OT.STP; 

HOVB 


f S T 0 P TAPE IN CASE 


100010 
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nr yco to diag print 



’04767 

0 T . R X T 5 JSP 

PC# DT.PR1 

yOM RECOVERY# 3 e T IP Pg TRY 


177400 




A (A jji 4 4 A 

n 1 3 7 3 b 
• 00 fH 4 6 

MOV 

#*V.PRES,F5 

? RESTORE USER REGS 

•a i? 0 4 5 0 

004blb 

JSR 

R5, *P5 


00045? 

100002 

RTI 

.r L 0 C^ not fount 

1 in search: 

J... 1 HOPE FOR BETTER. THINGS! 

/• 7 4 5 4 

016746 

1 7761* 

OT.BFR; MOV 

DT,BCK#-(SP) 

I (51 VE BLOCK NO, AS EVIDENCE 

O1M04 6'’ 1 

0 1 ? 7 4 fe 
001416 

MOV 

«OT,BRE#-(SP) 


0K0464 

012701 

177342 

MOV 

#DT.CCM,R1 

y GET CONTROL ADDRESS 

0 £ 4 7 r- 

00*760 

6R 

; TR4NSFE P ERRORS 

DT, STR 


000472 

032741 

*34000 

DT.TfcR; BIT 

# 3 4 0 i) 3 , - ( P 1 1 

STAFF FAILURE/OPfRATOR FAULT? 


001342 

bNE 

QT.EXT 

? IF SO PRINT A WAIT RECOVERY 

00050 * 

032721 

10*400 

BIT 

*100400, (PI) + 

y END 70 M t/N.F.M? 

v5O*tf504 

0 0-1027 

BNE DT.FER 

;RECOVt°A3Lt ERRORS (TIMING OR 

1 IF SO TREAT AS FATAL 

PARITY); 

0 g! (4 5 (? 6 

006327 
00 0 000 . 
0005 1 0 

ASL 

0T,RTC=.-2 

# 0 

yRETPTFD 5-g TIMES M„RDY? 

0 0 0512 

1 03352 

BCC 

DT.RXT 

f IF NOT TRY AGAIN 

3 £/■ 0 514 

* 5 2 7 6 1 
10003b 
r * t cit 1 y 

BIS 

#100000# 12 (W 

jOTHFPWTSE SIGNAL ERROR 

000522 

110321 

MOV R 

R 3# ( R 1 ) + 

y STOP TAPE IN CASE 

000524 

016132 
000001 
3017 1 0 

MOV 

1 CPU » R2 

J . . .RUT CHK ALL WORDS DONFJ 

00053* 

8EQ 

DT, TXT 

y IF so THAT'S IT! 

300532 

360330 

ADD 

R.3,R0 

y GO TO *QRD COUNT IN QDB 

3 0 0 534 

162032 

S ! ‘B 

(R0)+#R2 

* USE TO DETERMINE 

300536 

-ti r \ r* t r^i n 

St.? T *J"£ 

3UO 

R2 

NO, OF BLOCKS DONE 

0 f* 064* 

130321 

3IT5 

R 3 # ( R 1 ) + 

yCHFCK present TRAVEL 

■000542 

001401 

BEQ 

• +4 

yADJUST NO, ACCORDINGLY 

000 s * 4 4 

005402 

NEG 

R2 


300546 

067267 

177514 

AOD 

R2,DT.BPQ 

y MODI F Y SEARCH START BLOCK 

000552 

005067 

177732 

CLR 

DT . PTC 

y... & RETRY COUNT 

000556 

004767 

177336 

JSR 

PC # DT . PR2 

y GO SET UP MEN START 

3P0562 

000730 

BO 

jFATAL FRRORS - 

DT * RXT + 4 

END ZONE OR NON 

y • • • l WAIT RESULTS! 

-EXISTENT MEMORY? 

000564 

'’11046 

D T . F E p S MOV 

*p0,-CSP) 

yGIVE CALL AS EVIDENCE 

000566 

012746 

00141b 

MOV 

#DT,PRE»-(SPJ 

yPRTNT DIAGNOSIS 

00^672 

000717 

BR 

DT.PTP 
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T M I S C F U. A £ n U ? d F F T N T T 1 0 N S s 
•V'f 4 4 V.RSAV*44 
'M/Pt-ie y.RPESsae 
ot.oipsi^i 

177340 OT.T3T5177340 
177342 OT*CC M =177342 
17 7346 OT.CSAet 77346 
1.77350 OT.CDTsI 773^0 
*00432 )T,MRF = 4y2 
7 004 *4 -3T,IRFs404 
'^1415 0 T , F R F b 1 4 1 5 
101416 i)T,RRFs1416 
'* 0. P Ci i* 1 ,FMO 


000000 F k R C F S 


n? 

000007RG 

PT.BCK 

e vr 4 ?2 7?» 

PT.FFP 

7I70454R 

OT.BFC 

i-.T 0 264 ^ 

OT.BRE 

» 001416 

PT.8R5 

s 5J30266R 

DT.C«A 

= 177346 

pr.cc>' 

« 177.142 

PT.C.DT 

= 177157 

DT.DTR 

a S - ■ £• 1 0 0 

r> T.EXT 

3 5CM04R 

HT.FFR 

320564R 

DT.FRE 

s 415 

PT.FPO 

b 330302R 

OT.JNT 

03.713J 7R 

DT.IR£ 

s 0:*e404 

FT .NAM 

rf’Wl 4R 

HT.NRE 

a £530402 

0 T , P 3 1 

0-H M4R 

f-'f.PR? 

P P( 7 01 R 

PT.RTC 

b 37051 nip 

DT.RX7 

0 rt M4M 

FT. SEP 

•730355R 

3T.SIP 

310162R 

D T . S 3 Vi 

B 0 v' 1 2 0 1 R 

PT.STP 

3*30 43?R 

PT.SXT 

3 M256R 

DT. TAC 

* fc?*.2l2R 

cr.TAi 

4^02£2R 

DT.TA2 

173242R 

DT.TFP 

0f'047?R 

FT. TFP 

3 •' p <M 3 R 

r»T.TST 

a 177541 

DT.T*T 

fcp£l52R 

p c 

a % 0 ^ 0 0 0 7 

R0 

S X 0 ^ 0 7 {* ^ 

R1 

a'U’rH-'H-l 

R2 

S % 0 3 0 t* 3 2 

R3 

= X 0 3 0 55 0 3 

R 4 

a % 0 H £ ^ 0 4 

kb 

■ XBT'anias 

SP 

a % 3 4 0 3 0 6 

V.PRFfj 

s p^f'Mfi 

V . P S A V 

B 0 ’p!'44 

* 

= 0 7 0 57 4 R 
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RF11 DISK DRIVER 


The RFii Disk Driver consists of routines to initiate block transfers 
of data to or from the disk and to handle interrupts arising from com- 
pletion or through failure. 

It does not include OPEN & CLOSE processors. As a file-structured 
device, these will be unnecessary owing to the form of the Monitor 
f ile-manan,gement system. SPECIAL FUNCTION processing is also omitted. 
If it is found necessary to simulate the hardware function of a similar 
device, the necessary routine could be added later. 

This driver is part of the permanently resident Monitor when the 
RFll is the system disk. 

The driver is in two parts: 1) a table providing the interface 
between the driver and the Monitor, and 2) the routines to service the 
calls for disk operations. 

1 . Driver Table 

The Driver Table (DF) occupies the first nine words of the driver. It 
complies with the standards specified for all Monitor-driver interfac- 
ing in general, and for file-structured devices in particular. The 
descriptive elements of the table are set up as follows: 

Mu ^a-t-aao-t- h^nrl] l nrt on ^ 

»■* -j — - — 

single unit. 

Input & output in ASCII or 
binary. 

File-structured with no limit 
to the number of files that 
may be in creation at one time. 


b) 

Standard buffer size: 

64 

c) 

Interrupt vector address: 

204 

d) 

Interrupt servicing 
priority : 

5 

e) 

Device name 

DF 

f) 

Directory start block: 

1 

g) 

No. of bit map pointers: 

1 


Facilities avail ab 1 * 
= 100037 
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2. Service Routines 


The driver contains two routines: Set-up Transfer and Service Inter- 
rupt . 


2 . 1 Set-up Transfer (DF.TFR) 

This routine first initializes a counter which is used to control the 
number of retries in the event of parity or timing failure. Using the 
address of the DDB for the dataset it is servicing (as supplied by the 
calling routine in the first word of the driver table), it then col- 
lects control data from the DDB and transmits it to the hardware regis- 
ters for the RF11, beginning at 377460. 


Two of the items involved require special processing before out- 
ward transmission; the rest are moved directly. 


1. The driver block number set into the DDB must be con- 
verted to meet the platter and word structure of RF11. 
All the platters currently under one control are con- 
sidered as a single continuous surface. As a result, 
the most significant bits of the block number repre- 
sent the appropriate platter number and the remainder 
the word starting the block. The required conversion 
is therefore merely multiplication of the block number 
by 64 across 21 bits. 

2. The function bits contained in the DDB automatically 
produce the required transfer operation. To them, 
however, must be added the INT ENB & GO bits (combined 
value 101) needed to set the RF11 Control Register 
correctly for the transfer operation to begin. 


On completion of the set-up, control is returned to the calling 
Monitor routine via the interim return address stored on top of the 
stack by the calling sequence. 

2 . 2 Interrupt Service (DF.INT ) 

The RF11 control causes a priority-5 interrupt either on satisfactory 
completion of the transfer or because an error has been detected. 
Having saved the processor registers on the stack, the servicing rou- 
tine must determine which of these events has occurred by examination 
of bit 15 of the Control Status Register. On transfer completion, it 
collects the address of the DDB it is servicing from the first word of 
the driver table and uses it to return to the completion address set 
in the DDB. At this exit, R0 is set to the DDB address, as required 
by the established convention. 
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An error may be one of the several types as indicated by further 
bits of the Control Status or Extended Status registers. The servic- 

( 1 ) Errors which can be handled internally 

Parity or timing failures may be eliminated on a second or later at- 
tempt. For the sake of simplicity, a retry is initiated by restarting 
the transfer from the beginning again rather than from the point at 
which the error was detected. If finally the eighth attempt produces 
no satisfactory result, the processing routine sets Bit 15 of Word 
DDB+12 to show the failure. It then checks if any words still remain 
to be transferred beyond the failing one. If so, it attempts to re- 
sume the transfer from this point. If this is successful, it then 
takes the normal completion exit. Further failure, however, is 
treated as fatal. 

(2) Errors which must be rectified (if at all) by the operator 

All other failures cause an exit to the Error diagnostic print routine, 
with DSK ERROR F026 as the message and the contents of the Control 
Status register as evidence. Write lock-out or non-resident disk 
may be the result of an operator fault. The operator may be able to 
correct this and resume program execution by the appropriate keyboard 
command. Such action will probably be impossible in the case of a 
non-existent memory error, and other errors classified as 'HARD' in the 
RFll Specification or after persistent parity or timing failures. 

(3) Program Listing 

A complete assembly listing of the driver follows. 
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•copyright 1971, ^ m j 7 a i foii spent corp., mavma? d, 'usg. 
{VERSION MU'IBFRt V \ A 


.titlf df 
{DISK DRIVER (RF1!) 

j 3 T A . 1 D • A l. 0 ' * F DRIVER EXPANDED F R 0 M THAT USFD AS A 

* hesidfnt monitor ROUTINE for system USAGE 

i CONTAINS SET * ip & TPAMSFRP ROUTINES OML Y 

■^i«r.gc»to 

R1*%1 
f *W 1 d <*2 R?a*<2 
*000*3 R3s%3 
■H *004 R 4 s %4 
*?*005 R5 = %5 

?r> ■?£•<?& sp=%6 

*t *r*7 PC = %7 


.01091 DF 

jTASLE OF STANDARDS and pot u T f PS 


ti p p a 0 r> 

.‘1 0 » 0 0 0 •) F * 

.WORD 

0 

{CURRENT DDR ADDRESS (0 IF IDLED 

? 0*9*9? 

rv 

.BYTE 

37 

ySTAMDAPD facility indicator 

000003 

2 ■* 0 

. BYTE 

2'H' 

r ( NORMAL & FILE-BASED) 

0P0 ’'04 

0id 

. btte 

4 

;STANDA p n BUFFER SIZE/16 

0 p 0 •'* 0 ft 

1 '*2 

.BYTE 

DF, INT-DF 

■ T . V , CONTENT 


2 <10 

.byte 

2 1 0 

; PRIORITY FOR T.V. 

■.'■■{■'(.; 7 


.BYTE 

*> 

Vi 

{ DESPATCH TABLE 

* fl 3 1 p 

1 ?2 

.byte 

OF, TF'P-DF 

j shows tfr rtn only 

; 'i 0 »■ * 1 1 

t *V 

.BYTE 

;/» 


0 0 0*1? 

[/ -7 £ 

. *YTE 

/ 


/ tv-'p 

!' 00 

.BYTE 

0 

JSPARF 

,1 r *;•* 1 1 a 

•‘ J 17 S'; OF. NAM* 

. ■? A U 5 D 

•Dpt 


0 * 0 * 1 * 

■'KrN 

. KJRD 

D E , D I » 

; M ED b j_ n 


‘H 

. ■'< 0 u 0 

0 

r R F 0 IJ I R F 0 FDR BIT MAP I NF p 


{fRANSFFR 1 1 T T J A T F 


000 122 

U17S7 

’(•■• r *l 1? 

DF.tfr: 

M D V 

©PC,DF.RTC 

?7ERC RFTRY COUNT 

0 (A 0.-2 a 

111737 

1 77461 

UF.RPT: 

U 0 V D 

©PC, »*0F.PCS+1 

{CLEAR DISK IN CASE OF ERROR 

DD 0 ‘’3? 

M 67 *2 

1 77742 


NOV 

D F / R 3 

; GET DOB ADDRESS 

i>.i f'.i 0 13 * 

‘2?r?0 


CUP 

(Rm? + » C R 0 ) + 

JRUMP POINTER TO BLOCK NO, 

0 P 0 D 4 P 

0 1?732 
177472 


MOV 

aDF.0CS+l?,R2 

{ SE T HWR POINTER 

0 7 0 0 4 <1 

111/03 


0 0 v 3 

©RC.P3 

?SFT tjp BLOCK CONVERSION 

0 0 0 1 4 A 

oi2L"4 


hi D V 

(R0)+#R4 

{GET BLOCK NUMBER f******) 

#00 *80 

■ 0 fr 63D4 


ASL 

R4 

{CONVERT TO WORDS 

0000b? 

10 * 1*3 


rolb 

»3 


30 00b 4 

1.03375 


BCC 

.-4 


0L0 ;, b6 

0 1 0 3 42 


M n y 

R3,-(R2) 

; SET 'JR DISK ADDRESS % EXT. 

300 0ft 0 

*1*442 


MOV 

R4,-(R2) 


4000ft? 

0 1 ? 0 4 2 


MO y 

(R0)+,-(R2) 

{MOVE IN wqro COUNT ... 

000064 

M?M2 


M 0 V 

(R0)+,-(P 2) 

;ft MEMORY ADDRESS 

0 0 0 0 § ft 

0120*1 


MO v 

(R0)+, Rl 

{GET FUNCTION 

0D0070 

151 701 


BIS* 

©°C t R1 

• Apo I NT ENB ft GO 

0 0 0 0 7 ? 

* 4 ? 7 10 1 

1 77470 


riic 

A 177470 ,R 1 

{REMOVE OTHER GARBAGE (******■) 

0 0 0 0 7 A 

M*i 42 


MOV 

R 1 .-CR 2 ) 

{ SEND TO CONTROL 

30010O 

00*207 


RTS 

PC 

{RETURN TO MONITOR FOR NOW 


;(******) - C ARF J M i USED AS LITERAL BY PREVIOUS INSTRUCTION 
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jINTFPR'IPT SERVICE 

d?kJl V? ’137 46 OF. IMi M^v 0«S.RSAV,~(SP) iSAVE REGISTERS 

" , rr’^44 

37^1 4* 304536 JSK R5,e(Sp)+ 

*VS1 1 ’ “> J 2 7 ’ J «nv #DF.DCS*R1 ; FR°OR CAUSE INTEPWU 

177460 

3PtM14 ■’'15132 MTV (P15*,R2 

0PkJll6 1?3434 till QF.FRR l YES - QQ F I MO CAUSE 

<19101 *1*730 MOV OF,R0 f GET DD* ADDRESS 

177654 


300124 

*16037 

T\ i'f< :> r> 1 a 

DF.X1T: 

MOV 

1 4 C R0 ) , PC 

jRFTUPM MONITOR 



j ERROR 

PO IT INF 

• 

• 


30*5133 

’327 1 2 
0J H 30 

OF, ERR: 

HIT 

fflino0,R2 

fPARITY OR MISSED? 

000 I 34 

301423 


BEQ 

OF. OFF 


302136 

■’06327 

OF, A GV ; 

A.SL 

# ’ 

•YES - RETRIED a TIMFS? 


V>0 1 u- 

DF.RTC* 

mO 

• 



400142 

103436 


HCS 

OF, PER 

? IF SO FORCE CONTINUE 

5j 0 01 44 

’04757 

177656 


JSR 

PC,DF.RPT 

?0THERWI5E TRY AGAIN 

v F 0 1 5 r ' 

313/46 

■■*F-«P 4 6 

of. RFC: 

M 0 V 

P«S.RRE8,*(8PY 

1 RESTORE SAVFO PEGS. 

.1 r* £1164 

’0:4636 


JSR 

R5, ® (SP)+ 


300156 

30 30 32 


RTI 


?... % EXIT FOR NOW 

000163 

’62760 

1 0’0 ’3 
’£‘•’*12 

OF, PER: 

RTS 

# 1000 * 0 , i?(R-5n 

JRFTIJRN PARITY FAIL FLAG 

3001 66 

H ^7 1 1 


TST 

j»ri 

: ALREADY AT BLOCK END? 

. m .0 1 7 rs 

N 17 55 


HE -2 

D F , X I T 

t IF SO FXTT NOW 

000172 

0 57 6 7 
177742 


TST 

DF.RTC 

; OTHERWISE CHECK IF 2ND TIME 

300176 

001432 


BEQ 

OF. OFF 

; IF SO NO POINT IN MORE 

i* fS ;/ 2 0 3 

V5?4l 


IOC 

- ( R n 

J COATIN' IE DISK TPANSFFR 

0 ?: 3 20 ? 

’*027 62 


BR 

DF.PFC 

VIA COMMON FXIT 



: f R P c P 

T 3 MOT 

immediately recoverable? 

0 {• 0 20 4 

* 14 14 6 

OF. OFF; 

« 0 v 

-(R1),*CSP) 

j DISK STATUS IS EVIDENCE 

3 0 3235 

*12746 


M “ 1 V 

#DP.ENO,-(SP) 

; SET UP FPROR Nn , 

g 0. 0 2 1 9 

00 1 4 26 
300*004 


I 3 T 


• GO TO 31 AG* PRT* 


» D E F I M I T I 0 N S • 


000044 3.RSAVe4 4 
300046 3.RRES*46 
1 77460 OF. OCSsI 7746S? 
‘ r""’ O' M OF.DIPsl 
36*14 26 0F,Fhin*14?6 
’ 3 3 f 1 . F N r, 


k r 'Wit) n ERRORS 


OF 

0 3 0 3 0 0 R G 

OF . AON 

001711 36 R 

PF.DCS 

* 177463 

DF.DTR 

s 000001 

OF.EUQ 

* -331425 

OF. ERR 

3 ’31.33R 

OF. I v T 

0 0 01 0 2 R 

OF. MAM 

3 0 0 P 1 4 R 

OF .OFF 

3 *02043 

DF .PFR 

£30 160R 

OF .REC 

0301 53R 

OF.RPT 

070O26R 

DF.RTC 

s ?. 3 0 1 4 0 R 

DF.TFR 

370P22P 

OF.XIT 

3 0 0 1 2 4 R 

PC 

= % 0 3 £ 3 £ 7 

Pd 

s*09000« 

R 1 

■X303301 

R 2 

= X 0 3 0-702 

R3 

8*000003 

P4 

a*0'*?004 

Rt> 


sp 

= % 4 3 0 P 2 6 

S.RRES 

s 003046 

S « R S A V 

s f 0 0 M 4 4 

• 

* 3002 14R 
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Section I 


PCii HIGH-SPEED PAPER TAPE READER DRIVER 

The paper tape reader driver provides the device dependent I/O func- 
tions for the PDP-11 paper tape reader. To allow the common I/O pro- 
cessor to be device independent, the paper tape reader driver is a 
block processor. Any size block may be processed by the driver, but 
to provide the most efficient operation the standard buffer size is 
32 words. The driver code is position independent. 

1.1 DESCRIPTION 

The paper tape reader driver consists of two sections: the standard 
driver header and the driver body. 

The driver header gives the following information about the paper 
tape driver: 

1. Capabilities 

a. Single user 

b. Input only device 

c. ASCII and BINARY both may be handled 

d. Non-file structured 

2. 32 word standard buffer size 

3. Interrupt entry address and priority (4) 

4. Dispatch table containing entry addresses for: 

a. Open 

b. Transfer 

5. Internal word count and buffer address 

The driver body contains the code to perform the three paper tape 
reader functions: opening, reading (transfer), and interrupt servic- 
ing. 

1.2 OPEN 

The OPEN function for the paper tape reader exists to give the user a 
means to ensure the reader is ready for operation (i.e., contains tape, 
is turned on, etc.). The OPEN routine tests the tape reader status 
register for an error indication. If such exists, an A002 message 
(Device Not Ready) is printed to the operator. The check is repeated 
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following a return from the Diagnostic Print routine indicating that 
the operator has requested continuation. Because no interrupt is neces- 
sary to make this check, the routine merely removes the interim return 
address stored on the top of the processor stack by the calling sequence 
and takes the completion exit immediately (since this driver is for 
single-use only, there can be no queue for its services, hence it need 
take no action to cater for a queue situation) . 

1.3 TRANSFER 

The TRANSFER entry initializes the driver and initiates the read of the 
first character. Initialization consists of storing the byte count 
(2 * Word Count) and buffer address from the calling DDB into the driver 
header positions reserved for them, and enabling the reader interrupt. 

1.4 INTERRUPT SERVICE 

Interrupt servicing is the heart of the paper tape reader driver. The 
following flow chart gives a detailed explanation of this function. 



It should be particularly noted that an error during interrupt ser- 
vicing signifying "Reader Off" or "Out of Tape" is considered an "End of 
Data" and is treated accordingly. 
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1. 5 Program Listing 

A complete assembly listing of the driver follows 


|CQPY D IfiHT 197J, DIGITAL EQUIPMENT CHRP,, MAYNARD, MASS, 
i VERSION NUMBER? V001A 


? PAPER TAPE PEADEP DRIVER (PR) 




_ . 

.TITLE 

PR 





.GLOBL 

PR 



300030 

R0s%0 


.... 



■300001 

R1=%1 





300032 

R2»%2 


. ... 

... . - 


303033 

R3*%3 





00p | 0p<4 

R4a%4 



. - ... 


700005 

R5s%5 





007006 

SP = 7.6 



- • 


303037 

PC = %7 






j . PREAMBLE 




0 0 0 3 0 0 

300030 

pRt 

, 40RD 

0 

iDCURRENT 0DC8 OR 0 

00.0002 

234 


.BYTE 

PR, BP 

l FACILITIES -INDICATOR — 

000303 

000 


.byte 

0 


0 0 07 04 

£32 


.BYTE 

2_.. 

t STANDARD BUFFER SIZE--/- 16 

3P0O0* 

£‘56 


.BYTE 

PR.TNT-PR 

? INTERRUPT address 

000706 

23 0 


. .BYTE 

230. 

A. PRIORITY 4 INTERRUPT. 

000707 

170 


.BYTE 

PR.OPN-PR 

t DISPATCH OPEN 

000710 

122 


.BYTE 

PR ,TFR-PR 

? TRANSFER (IN) 

000011 

03 0 


.BYTE 

0 

* CLOSE 

000 7 1? 

030 


.BYTE 

0 

{ SPECIAL FUNCTIONS 

000713 

£ 3 0 


.BYTE 

id f DUMMY 


000^14 

363320 

PR, NAM: 

• RAD5C 

'PR' 

. . ... 

00071* 

300030 

IMTCnT: 

.WORD 

0 

1 INTERNAL COUNT 

000720 

ffl 0 0 £ 3 0 

stqadd: 

.WORD 

0 . 

i STORE NEXT ADDRESS 



1 MAIM 

DRIVER 





; BEGIN TRANSFER . 

._ 

0007?? 

0167-30 

pr, tfr: 

MOV 

PR,R0 

f GFT ODb 


177752 



..... 

... ......... 

000.72* 

316074 


MOV 

17(R0) , P4 

f PRESE®VE USER COUNT 


300010 





00073? 

706374 


ASL 

R4 

? BYTE COUNT 

000734 

710467 


MOV 

R4 , INTCNT 



177756 





000740 

016067 


MOV 

6 (R0) f-STDADO 

? -SAVE BUFFER ADDRESS- 


000006 






177752 




....... . . 

000346 

352737 


BIS 

#101 /P#PR » C3R 

i ENABLE INTERRUPT 


00 p.l 31 




.... _ ... ... 


1 7 7 5 5 £ 





000354 

300207 


. RTS... . 

PC ..... 

i-.RET.URN . 



j THE PR IS DRIVEN BY THE FOLLOWING INTERRUPT ROUTINE 

0007 5 6 

705737 

PR.INT: 

TST 

MPR.CSR 

f TFST FOR ERROR 


177551 




.... 

00076? 

1004 U 


BMI 

PR, ERR 

? YES 

070764 

11377/ 


MOV 3 

##PP.„BUF.,®STOADD 

» STORE-CHARACTER - ... ...... 


177552 






177726 





00037? 

3052*7 


INC 

STOADD 

| UPDATE 


177722 




- 
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000^76 

0052*7 

INC 

INTCNT 

: pointers 



177714 




. .. .. • 

002102 

301434 

BEQ 

PR.DNE 



000 104 

052737 

BIS 

#1 21 ,-**PR.C SR 

! 7 ENABLE 

. ... - 


000101 






177553 



.. 

. ... 

000112 

000002 

RTI 


f AMO RETURN 




PR. ERR: 

... ... . 

. . . 

.. - 

0001 14 

013746 

pr.Dmf: mov 

•app.SAV,-(SP) r set up jsr 



000244 





000120 

004536 

JSR 

R5,e(SP)+ 



302122 

105037 

PR.DIS: CLR8 

P^PR.CSR 

? DISABLE INTERRUPT 




177552 





000126 

016700 

MOV 

Pil# R 0 

. : DOB ADDRESS 

.. ... 


177646 





000132 

016701 

MOV 

INTCNT, R1 

- J REMAINING COUNT 

. 


1 77660 





000136 

001405 

BEQ 

PR.FRT. . 

f NONE — 

... 

000140 

162701 

SUB 

#6, R 1 

f ROUNDED TO WORDS 

(AND TEAR) 


300006 






000144 

006201 

ASR 

R 1 



300146 

.010160 

MOV 

Ri, 16CR3) . 

t RETURN RESULT TO CALLER-- ■ - 


000016 





000152 

00017 0- 

PR.FRTJ JMP 

P14CRP) 

: completion return 

.. . . 


0000 1 4 







t QPEM ROUTINE: . 

.... ..... 



000156 

016746 

PR.OPP: mov 

PP,NAM,-(SP) 

f ADDITIONAL INFO 



177632 






000162 

012746 

MOV 

#402, -(SP) 

1 NOT READY - 1,2 ERR 

MSG 


.000402 





000166 

000004 

IOT 




000170 

005737 

PR.OPW* T ST . 

P.APP.CSR - 

- : TAPE. READY 



177550 





000174 

100770 

BMI 

PR. OPR 

; NO 


000176 

026726 

TST 

(SP) + 

jCLFAR CALL FR0 M STACK 

000230 

016700 

MOV 

PR , R0 

jGET DDB ADDRESS 



177574 





000204 

.000762 

BR 

PP.FRT 

. j*. • • & TAKE- COMPLETE RE-TN-. - - 


177552 

PR., BUF* 1 77552 





177550 

PR, CSR*1 77550 





000234 

PR . BP»234 






0£*P£ M4 

PR,SAVb44 





000001 

.END 




002000 ERRORS 


— 



— 

INTCNT 

000016R PC 

b%0£10007 

PR 030003RG 

.... 

. ...PR, BP .. 

• .M0234 

PR. BILE 

.* 177.552 

PR,.CSR~ji 1 77-550 — 

.. , .. . . 

PR.DIS 

000122R PR. ONE 

3001 1 4r 

PR. ERR 000114R 


PR.FPT 

„J 0.0 152 R,... . ... PRa.tr 

02L0056R .... 

PR^iiAM 030014J3 - . - 

— , , „„„ 

PR. 0PM 

00B170R PR. OPR 

030156R 

oR.SAV s 000344 


PR.TFR 

0.00022R. P0 

MX 000.000 

Si— *%330001— 



R2 

»%000322 

R3 

b%000003 

P4 »%030004 


R5 

».%M0005 

SP 

= X 3.1000 6 

STDADD-- 000323R 



• 

* 0P2206R 
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Section II 


PC05 HIGH-SPEED PAPER TAPE PUNCH DRIVER 


The paper tape punch driver supplies the basic device dependent operat 
ing functions for the PDP-11 paper tape punch. To facilitate the de- 
vice dependent operation of the I/O common routines, the paper tape 
punch driver processes blocks of data to be punched. The driver will 
process any size block (as given in the DDB) but for efficient opera- 
tion a default (standard) block size of 32 words has been chosen. 

The paper tape reader driver provides open, close, transfer, and 
interrupt servicing functions. The open and close functions cause the 
paper tape punch to punch two fanfolds of blank leader and trailer 
tape respectively. The transfer function causes the punching of the 
given block of data. Since the PDP-11 paper tape punch punches one 
character at a time, the interrupt servicing function provides the ac- 
tual control of the punch for each of the other functions. 

2.1 DESCRIPTION 

The paper tape punch driver consists of two distinct parts: the stand- 
ard driver table and the driver body. 

The driver table contains the following information: 

1. Facilities indicator - The facilities provided 
by the paper tape punch driver are: 

a) Single User 

b) Output only 

c) ASCII or Binary format 

d) Non-file Structured 

2. 32 word standard buffer size 

3. Run at priority 4 

4. Internal information 

a) Trailer Indicator 

b) Internal byte count 

c) Internal (byte) buffer address 

The code for the paper tape driver is organized as follows. The 
open, close, and transfer routines perform their initialization pro- 
cesses and control is transferred to the interrupt service routine for 
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actual control of the data transfer. The initialization processes con- 
sist of setting the internal byte count, the beginning buffer address, 
and the trailer indicator ( 0 implies open/close in process, 1 otherwise). 
The interrupt servicing routine is then called. Leader/ trailer punch- 
ing and actual transfer punching differ only in that the internal buf- 
fer address always points to a zero in the former case, and this point- 
er is incremented through the block in the later case. Upon total 
completion of the requested operation, the DDB completion return is 
taken; the DDB intermediate return occurs immediately upon initiation 
of the punching of the initial byte. At each interrupt the detection 
of an error (Punch Out of Tape) results in a request for an A002 mess- 
age at the console (Device Not Ready) . If a return from the Diagnostic 
Print routine occurs, indicating an operator request to continue, the 
function is again resumed. 

2-2 Program Listing 

A complete assembly listing of the driver follows. 


jCOPYPIGHT 1971, DIGITAL EQUIPMENT CORP,, MAYNARD, MASS, 




j VERS TQM NUMBFRl 

I V 0 0 1 A 



000000 

000001 

000002 

.TITLE 
, GLOBL 
R3»%0 
RUX-l _ 
R2»*2 

PP 

PP 

■■ - — — 


. 000003 
000004 
000005 
000006 
300037 

. . - - - 

R4*%4 
. R5»%5 

S P * % 5 
... - - PC«%7 

j PAPER TAPE PUNCH DRIVER (PP) 

- - 

... 


i . preamble 

■ - • - - 

- - - - - 

000000 

i 300.000 

PPs « WORD 

2 - _ .... - 

? -CURRENT- -DG©- OR- «--- 

00000? 

332 

.BYTE 

PP.BP 

» FACILITIES 

.000003 

000 

_.. .. .BYTE 

2 .. 

. - ............... 

000004 

002 

.BYTE 

2 

J 32 WORD STD BUFFER 

0.00005 

. 074 

• B Y.T£ .. 

PP^IN-T-pPP. 

. j IftAMSEEP- ADDRESS . - ~ _... 

000006 

200 

.byte 

230 

J STATUS 

000007 

2.06 

... --.BYTE 

PP.QPN.PP 

j _RELAXUV£ - A DURESSE 3- FOfthPEN— 

000010 

024 

.BYTE 

PP.TFR-PP 

1 TRANSFER 

000011 

.206 

.BYTE 

PP.CLS-PP. 

t CLOSE- - - . ... - 

30001? 

000 

.BYTE 

0,0 

1 SPF & SPARE 

00M13 

000014 

... . 000 

063200 

PP.NAM* , RAD50 

ippi 



0000.1$ 

000001 

PP.TSLi.. •J'fOBD .. 

.1 , . 

4 JRAZLSS I N D OCA. T-0 R— ■ 0- . 

000020 

000000 

PPCT* .WORD 

0 

1 INTERNAL COUNT 

00002? 

000000 

P P FPT t. ...WORD.. .. 

a. 

4-XLLR-RE-NI— BUFF-ES- POIMIEP- 


I 
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S DRIVE! 

? 300 

000024 

*167*0 

177750 

PP.TFRJ 

MOV 

00003? 

* 1 6067 
*000*6 

177764 


MOV 

000*36 

.01 6004 
00*010 


MOV 

000042 

*06304 


A3L 

300*44 

* 1 *467 


MOV 


177750 



300050 

112767 

000001 

177740 


MOVB 

00.0.056 

*11646 

PP.UEH: 

MOV 

000*6* 

*13766 

177776 

*0*E02 

- 

MOV 

000.066 

313737 

*000.76 

177776 


MOV. 

000074 

*05737 

PP.INT! 

TST 


177554 


PP,P0 ? GET CURRENT DDB 

6 (R*3 » RPFPT t GET BUFFER POINTER 

1 0 CRfiD »R4 > P-RE3ESV£. .WO RO~ COUNT- — 

R4 . -? CONVERT TO BYTES - 

R4,PPCT I AND SAVE 

#1,PP.T9L 1 RESET TO TFR 


(3P3 # -CSP) ...rS.IHULA.TE. -INTERRUPT-- — 

P#ST, ATS,2(SP) ? FROM JSR PC, XXX 

®#PP ,.VCT t ? AST. ATS - —f RUN U M OEA _BUMCW--S T4T-U S- 

?«PP,CSR t PUNCH OUT OF PAPER OR OFF 


3*0100 

000.102 

10*434 

305.767 - 
17771 1.2 


SMI 
. . Tai.- 

PP.ERR 

...PACT 

> YES 



300106 

.321.416.. 


BEQ . 

.PP.„DNE 

r-AL-R-EABY FTNISHE9 

0001 1* 

*05267 


INC 

PPCT 

i COUNT THIS ONE 


177724 



. . 

. . > 

0*0114 

117737 


MOVB 

$PRFPT , 

®#PP,BRG t MOVE CHARACTER TO PUNCH 


177702 

177556 

- 

.... 

— ..... 

■ - ■: ■ 

003122 

1357.67 

177670 


. TSTB 

PP*JAL 

... I_ ..TRAILER -OR- -NO- ^ 

0P0L26 

*01402 


. BEG 

. PP-.NQI 

; -TRA ILER — — 

00013* 

*05267 


INC 

PPFPT 

f NEXT ADDRESS OF BUF. 


177666 ... „ ... 

000134 052737 PP.NOIs BIS #10*, ®*PP«C3R j ENABLE INTERRUPT 


.. . 00*100. . _ .. 

177554 

000142 000002 - RTI j_A£TURN 

000144 013767 PP.ONFl MOV PSPP.SAV, .f 10 j SAVE REGS FOR RETURN 

00004.4. . , 

O00002 

000152 004537 J3R . ... R5*«P0... _ _.. . ._ 

000000 

00015.6 00503.7 CLR .«L#J?P_. CAR . _. r -HIS ABLE - -INTERRUPT — 

177554 

000162.. 01670.0... PJU1G.N.I.. . 14 OIL PS * Rfl 4 -CURRENT DDB- 

177612 

000.166 000170 JMP. f 14.CR0). . ... j. .COMPLETION -RETURN 

000014 

000172 012746 e.P.*£fifH ...MOV J632aEU- (SPI. — | SHOW -DEV I CE NANE. 

*63200 

.000176. .0127.46 ... MOV #40.2 *-£32.1 rJlRINX_Is2_£RH_tASG 

00*402 

..000202.000004 .. 1D.T ... 1 not RFApv : 

0*0204 00*733 BR PP.INT 

PP.OPNl 
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000206 106067 PP.CLSi CLRB PP.TRL > INDICATE TRAILER OPERATION 

000212 010767 ~ MOV PC, PPFPT 

. . ...... 177604 — 

000216 062767 ADD #PP , TRL*. , PPFPT } SET BUFADDR 

17760.0 - 

177676 

000224 0127.67 . MOV. J* 127524* PRCt 4..Z. .£0|J1S- TAA.U.ER 

177524 

177566 _ - . .... 

000232 000711 BR PP.UEN ? NORMAL FROM HERE ON 


177776 3T.ATS*177776 
00007.6 PP.,.V£T*t.76 
177554 PP, CSP" 1 77554 
177556 PP.aRG«177556 . 

000044 PP,SAV*44 

.0.20.3.32 PJV3F.S.332 . - 

000-1 62 PP.8PF«PP.IGN 
_ .000001 .END 


a20M2L ERRORS .. 


PC BX0P0O07 

PPFPT. .0003228... 
PP.CLS 0R0206R 
.PP.ERR ... 000172R. 
PP.NAM 0020MR 
PP.SAV 1 000044. 

PP . TRL 0000 1 6R 
R0 . . J»X000000 

R3 BV000303 

SP . «%000006 


PP 000000RG 

.. PP^BP j.. 030332 .... 

PP.CSR = 177554 
. PP ..I.GN - 0001625 — . . 
PP.NOI 000134R 
.PP.3PF s 000152R . 

PP.UEN 000056R 
.. PI . . *2000001 .. . 

P4 =*000004 

.STOATS * ..177773- . . 


PPCT 0O0O20R 

i?p...09j;. «. 177353 

PP.DNE 000144R 

.0000745 — ■ ■ 

PP.OPN 000206R 
PP-.TFR . - 0 00.324 R ... 
PP.VCT * 030376 

.52- ... . ... a*0 30002.. . .. 

R5 **000005 

— * -0002345 — 
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RKll DISK DRIVER 


The RKli Disk Driver consists of routines which initiate block trans- 
fers of data to or from a disk cartridge and which handle interrupts 
arising from normal completion or errors. 

Special functions, OPEN and CLOSE processing, are not necessary 
and thus not supported. Advance seeks are not supported in this 
initial release for several reasons, among which are: 


• The majority of the DOS installations which utilize the 

RK have only one unit, so the extra code in the driver 
(approximately 25$, ~ words) would be detrimental in 
most cases. ^ 

"NT F\/“N Q « » j i-m X- a w. vn v* ^ *“* r- * J y'v X. V-\ *l *T* / -t m tm M V“ T- t V» 

W L\\J UOO oys UC1LI p J_ wy IT QillO uvj UiCXL X / KJ XII Cl UiailliCJ. 

would reap huge benefits by seeking ahead. 

• The Monitor would have to be altered to inform the RK 
driver before a Bus Init is issued. 


The driver should be assembled at each installation where 


(a) the RK is the system residence disk, or 

(b) low density drives are present. 

If the RK is the system residence disk, then define SYSDV at 
assembly time. If low density drives are present, then proceed as 
follows : 


(a) If all drives are low density, then define LOWDEN at 
assembly time. 

(b) If there is a mixture of high and low density drives, 
then define MIXED at assembly time and define CONFIG 
as follows: 

Imagine CONFIG as an 8 bit field, the rightmost 
bit of which corresponds to unit 0. If a bit in 
a given position is one (1), then that particular 
drive is low density. For example, CONFIG=12(8) 
[00001010(2)] indicates that units 1 and 3 are 
low density. 


LOWDEN and MIXED should not be simultaneously defined. If they 
are, MIXED is ignored, i.e., the assembly proceeds as if LOWDEN is 
defined and MIXED is undefined. If MIXED is defined, but CONFIG is 
not, an assembly error will result, viz., a "U" flag on the line 
labeled DENIND. 
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issued was not a drive reset (see below) , the completion return 
C@ (DDB+14) 5 is taken. If it is an error situation, then an attempt 
to re-try will be made if the error was one of 


(1) 

any " 

soft" error, 

(2) 

seek 

incomplete , 

C3) 

read 

timing error 

(4) 

data 

late, or 

(5) 

seek 

error 


All other error conditions result in a fatal error message. In 
addition, if the word count is not zero after eight re-tries , a fatal 
error message is issued. Otherwise, a parity error is returned. 


NOTE 

Errors (2), (3), (4), and (5) above are among the 
"hard" errors. A control reset must be issued in 
order to continue. Additionally, a drive reset must 
be issued in order to continue after a seek incom- 
plete. Thus, if the last function issued was a 
drive reset, the re- try logic is called. 


4 . Program Listing 

A listing follows, condi tionalized for 

(a) the RK not being the system residence disk, and 
Cb) all drives being high density. 
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030054 

006201 

AS* 

Rl 

ILEFT-JUSTIFY UNIT 

00005S 

00600 1 

RQR 

RI 


000050 

00600 i 

RQR 

Ri 


000062 

006001 

RQR 

Rl 

1 UN IT NO* AS DESIRED 

000064 

022020 

CMP 

(R{0) ♦, (R0) + 

f POINTER D08*9L0CK 

000066 

012002 

MOV 

(R0) ♦ , R2 




. IFOF 

MIXED 




.IFNQF 

LQwdEn 




MOV 

(PC) * » R3 

1 GET DENSITY PATTERN 



, WORD 

CONFIG 




A$L 

R3 

1 MOyE APPROP, to unit 



Dec 

R4 




©fjfc 

, o»4 




BCC 

.*4 

IIF LOW DENSITY ... 



ASL 

,ENDC 

09 

•adjust slock no. 



.ENOC 

.IFOF 

UOwoEn 




ASL 

.ENDC 

R2 



000070 

027227 

311303 


CMP 

R2,»*800« 

IIS block within bounds? 

000074 

103410 


8L0 

0 K I N 2 0 

IVES - BRANCH 

000076 

014046 


MOV 

•CRB) ,-(R61 

1 output illegal block number 

0001 00 

012746 

001435 


MOV 

#1435, - C « « j 

lANQ F035 

01*0104 

000470 


BR 

DKERZb 

1 ... after sysdv chk 

000146 

360201 

D K X N 1 0 I 

ADD 

R2 , R 1 

i ado in valid quotient 

0001 1 0 

006202 


asr 

R2 

1 AD J REMAINDER FOR DIV BY 12 

000 112 

306202 


A5R 

R2 


0001 14 

060 4i*2 


ADD 

R4 > R2 


0001 16 

0 1 0204 

DKIN20I 

MOV 

R2 , R* 

IDIVIDE By 16 - SAVE REMAINDER 

000120 

042704 

177763 


BIC 

#177760, R4 


000124 

040402 


BIC 

R4,R2 

ifxtract quotient ... 

000126 

301367 


bne 

DKIN10 

1... IF ANY BUILD RESULT 

000 1 3? 

0274J7 
0000 1 4 


CmP 

R4 , #1 2 . 

•CHECK REMAINDER 

000134 

000402 


BLT 

,♦6 

IIF BETWEEN 12 t 15 ... 

000136 

062/04 

0 0 0 0 0* 4 


ADD 

#4,R4 

1... CAUSE SURFACE INCR. 

0001*2 

060 4;’ l 


aqd 

R4,R1 

1 put sector Into rest 

000144 

012704 

177412 


MOV 

#RKD A , R4 


0001 S* 

01*114 


MOV 

Rl , #R 4 

1 SET UP DISK ADDRESS 

000152 

012044 


MOV 

(R0) (R4) 

1 SET UP MEMORY aooress 

000154 

012344 


MOV 

(R0)*,-(R4J 

1 SET UP WoRO count 

3001 5s 

012001 


MOV 

(R0) ♦, Rl 

1 put in the function 

000160 

151701 


Bisa 

•PC.Rl 

1 SET 1,0. E. AND GO BITS 

000162 

0*2701 

177*63 


BIC 

#1 77460 , H 1 

1 CLEAR GARBAGE •»*****• 

000166 

010144 


MOV 

R1.-CW4) 

ISEND FUNCTION to control 

000170 

0002*7 


RTS 

PC 




1 

»***##• 

USED AS LITERAL 

BY THE PREVIOUS INSTRUCTION 
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0*0310 

012715 

0*00*1 

Ok ME R i 

MOV 

#1,»R5 

I CL EAR THE CONTROL 

3003U 

105?i3 

DKMR00! 

T STS 

RR5 

IOQnE vet? 

000316 

100376 


BPL 

DKHR00 

/nO - LOOP 

00032* 

0327gl 

001000 


BIT 

#1003, R1 

IIS IT SEEK INCOMPLETE? 

000324 

001405 


BEQ 

OKHR05 

!NO - BRANCH 

0*0326 

010163 

0000*4 


MOV 

R1#4(R55 

IREPLACE DRIVE # 

000332 

012/15 

000115 


MOV 

#115# *R5 

I SET UP PoR DRIVE RESET 

000336 

000760 


BR 

OKER30 

jtake interim EXIT 

000340 

032702 

011470 

OKHR05I 

BIT 

#11400, R2 

ican re possibly go on? 

000344 

001334 


BNE 

DKER00 

iy&s • branch 

000346 

03?702 

02*0*0 


BIT 

#20000, R2 

IIS IT WRITE LOCK out? 

000332 

001742 


BEQ 

DKER15 

|NO • BRANCH 

000334 

010046 


MOV 

R0,-CR6J 

ISAVE BUSY FLAG 

000336 

016746 

177432 


MOV 

OKNaM, • {R0 J 

/output name 

000362 

012745 

000402 


MQ V 

#402, .(R6) 

/AND A 002 

000366 

04*737 


BR 

OKER20 

/.., % GO PRINT 


000*01 


• INO 



000000 

ERRORS 






OK 

4030i')0RG 

OKERP 

000232R 

OKER00 

000236R 

OKER10 

0 0 0 2 4 4 R 

OKER 1 5 

000260R 

QKER20 

000266R 

OK£R?5 

000274R 

DKER30 

000300R 

DKHER 

000310R 

O<HR0fei 

000314R 

DKHR05 

0 0 0 3 4 0 R 

DKINT 

000172R 

OK I N 1 0 

0P2106R 

D<IN20 

0001 18R 

OKNAM 

000014R 

okwepT 

000240R 

okrtry 

000044R 

OKSTRT 

000040R 

DKXlT 

000226R 

PC 

1X000007 

PS 

■ 177776 

RKBA 

■ 17741? 

RKCS 

• 177404 

RKOA 

■ 177412 

RKI) I R 

■ 0000*1 

RKOS 

« 177400 

RKER 

i 177402 

RKwC 

■ 177406 

R0 

•X000000 

Ri 

1X000001 

R2 

■*4000002 

R3 

■X000003 

R4 

■X000004 

R5 

■X000003 

R6 

■X000006 

S • RS A V 

* ****** G 

S.XlT 

« 

■ ****** 6 

■ 000370P 

V.RSAV 

1 000044 

V.KIT 

■ 000042 
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